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What is This Book About? 

This book tells you how to use the DSP (digital signal processing) Starter Kit 
or DSK with these tools: 

□ The DSK assembler 

□ The DSK debugger 

How to Use This Manual 

The goal of this book is to help you learn how to use the DSK assembler and 
debugger. This book is divided into three distinct parts: 

□ Part I: Hands-On Information is presented first so that you can start 
using your DSK the same day you receive it. 

■ Chapter 1 contains installation instructions for your assembler and 
debugger. It lists the hardware and software tools you'll need to use 
the DSK and tells you how to set up its environment. 

■ Chapter 2 is analogous to a traditional manual introduction. It lists the 
key features of the assembler and debugger and tells you the steps 
you need to take in order to assemble and debug your program. 

□ Part II: Assembler Description contains detailed information about 
using the assembler. 

■ Chapter 3 explains how to create DSK assembler source files and 
invoke the assembler, while Chapter 4 discusses the valid directives 
and gives you an alphabetical reference to these directives. 

□ Part III: Debugger Description contains detailed information about using 
the debugger. 

■ Chapter 5 explains how to invoke the DSK debugger and use its 
pulldown menus, dialog boxes, and debugger commands. 
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Notational Conventions 

This document uses the following conventions. 

□ Program listings, program examples, interactive displays, filenames, and 
symbol names are shown in a special typeface similar to a 
typewriter's. Examples use a bold version of the special typeface for 
emphasis; interactive displays use a bold version of the special 
typeface to distinguish commands that you enter from items that the 
system displays (such as prompts, command output, error messages, 
etc.). 

Here is a sample program listing: 

00001 .ps OFBOOh 

00002 .entry 

»»> ENTRY POINT SET TO fbOO 

00003 fbOO 5588 larp AR0 

00004 fbOl 55a9 loop mar *+, AR1 

Here is an example of a system prompt and a command that you might 
enter: 

C:> dska testf ile.asm 

□ In syntax descriptions, the instruction, command, or directive is in a bold 
face font and parameters are in an italics. Portions of a syntax that are in 
bold should be entered as shown; portions of a syntax that are in italics 
describe the type of information that should be entered. Here is an 
example of a directive syntax: 



.include is the directive. This directive has one parameter, indicated by file 
name. When you use .include, the parameter must be an actual file name, 
enclosed in double quotes. 

□ Square brackets ( [ and ] ) identify an optional parameter. If you use an 
optional parameter, you specify the information within the brackets; you 
don't enter the brackets themselves. Here's an example of an instruction 
that has an optional parameter: 
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The LALK instruction has two parameters. The first parameter, 16-bit 
constant, is required. The second parameter, shift, is optional. As this 
syntax shows, if you use the optional second parameter, you must 
precede it with a comma. 

□ Braces ( { and } ) indicate a list. The symbol | (read as 01) separates items 
within the list. Here's an example of a list: 

{ * I *+ I *- } 

This provides three choices: *, *+, or *-. 

Unless the list is enclosed in square brackets, you must choose one item 
from the list. 

□ In assembler syntax statements, column one is usually reserved for the 
first character of an optional label or symbol. If a label or symbol is a 
required parameter, the symbol or label will be shown starting against the 
left margin of the shaded box as in the example below. No instruction, 
command, directive, or parameter, other than a symbol or label, should 
begin in column one. 









symbol .set symbol value 













In the above example, the symbol is required for the .set directive and 
must begin in column one. 

□ Some directives can have a varying number of parameters. For example, 
the .word directive can have several parameters. The syntax for this 
directive is: 



Note that .byte does not ; word valu^ [,..., value n ) 

begin in column one. 



This syntax shows that .word must have at least one value parameter, but 
you have the option of supplying a label or additional value parameters, 
separated by commas. 
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Related Documentation From Texas Instruments 

This book describes the TMS320C2X DSP Starter Kit and related support 
tools. To obtain a copy of this document, call the Texas Instruments Literature 
Response Center at (800) 477-8924. When ordering, please identify the book 
by its title and literature number. 

TMS320C2x User's Guide (literature number SPRU014) discusses the 
hardware aspects of the 'C2x of fixed-point digital signal processors. It 
describes pin assignments, architecture, instruction set, and software 
and hardware applications. It also includes data sheet information with 
electrical specifications and package mechanical data for all 'C2x 
devices. The book features a section with a 'C1x to 'C2x DSP system 
migration. 

Trademarks 

IBM, PC, and PC-DOS are registered trademarks of International Business 
Machines Corp. 

MS-DOS is a registered trademark of Microsoft Corp. 
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Call the DSP Hotline: 


report problems 


(713)274-2320 
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documentation 


(800) 477-8924 



Report mistakes in this document Fill out and return the reader response card at 
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Houston, Texas 77251-1443 
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Chapter 1 



Installing the DSK 
Assembler and Debugger 



This chapter describes how to install the DSP Starter Kit (DSK) on a PC system 
running under DOS. 
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Hardware checklist 

Software checklist 
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Installation errors 
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What You'll Need 



1.1 What You'll Need 



The following checklists detail items that are shipped with the DSK assembler 
and debugger and any additional items you'll need to use these tools. The DSK 
module connections for an RS-232 cable are also discussed in this section. 



Hardware checklist 



□ 

□ 
□ 
□ 



host 



memory 



display 

power requirements 



An IBM PC/AT or 1 00% compatible PC with a hard disk system and 
a 1 .2 megabyte floppy-disk drive 

Minimum of 640K 

Monochrome or color (color recommended) 

A 9 Vac @ 250 mA ( or greater) power supply with a 2.1 -mm power 
jack connector, which is common to most wall-mounted AC trans- 
formers. A low-current UL transformer is recommended because it 
is designed to hold up under brief power surges. 



Notes: 

□ You may want to use the DSK's on-board power supply and regulators 
for external circuits. If so, you must not overload the circuit — do not load 
more than 50 mA. 

□ If you are using an external power supply, be sure you connect it correct- 
ly; the DSK is not warranted after you have made modifications to it. 



□ 
□ 
□ 
□ 



□ 



board 

port 

cable 

optional hardware 



miscellaneous 
materials 



DSK circuit board 

An asynchronous RS-232 serial communications link 
RS-232 with a DB9 interface 

An EGA- or VGA-compatible graphics display card and a large mon- 
itor. The debugger has two options that allow you to change the 
overall size of the debugger display. To use a larger screen size, you 
must invoke the debugger with the -I option. For more information 
about debugger options, refer to page 5-2. 

Blank, formatted disks 
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Software checklist 



□ 
□ 

□ 



operating system 
files 

miscellaneous files 



MS-DOS or PC-DOS (version 4.01 or later) 

dska.exe is an executable file for the DSK assembler 

dskd. exe is an executable file needed for running the DSK debugger 
interface 

Other files are included in your DSK package such as sample source 
files and additional documentation. You can find a brief description 
of these files in the Readme file included on your disk. Be sure to 
check the Readme file for the latest information on software 
changes and DSK operation. 



What You'll Need 
> ■ 



DSK module connections 

You need an RS-232 cable to connect your PC to your DSK board. The DSK 
is designed with a DB9 RS-232 connection mounted on the board. If you don't 
have the necessary cables, you can purchase them at your local computer 
store, or you can make them yourself. If you plan to make your own RS-232 
cable, follow the DSK module connections shown in Figure 1-1 . 

Figure 1-1. The DSK Module Connections for an RS-232 Cable 




Signal Name 


Pin Assignments 


DB25 


DB9 


Protective ground 


1 




Transmit data 


2 


3+ 


Receive data 


3 


2+ 


Request to send 


4 


7 


Clear to send 


5 


8 


Data set ready 


6 


6 


Signal ground 


7 


5t 


Carrier detect 


8 


1 


Data terminal ready 


20 


4+ 


Ring indicator 


22 


9 



t These signals are used by the DSK 
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1 .2 Step 1 : Connecting the DSK to Your PC 

Follow these steps to connect your DSK board to your PC: 
1 ) Turn off your PC's power. 

: cable to either communication port 1 or 2 on your 

cable to a 25-to-9 pin adapter, if necessary. 

4) Plug the RS-232 cable (or adapter) into the DSK board. Refer to 
Figure 1-2 for details. 




Figure 1-2. Connecting Your i 



' Cable Into Your DSK Board 



Power Supply 
Connector 



Analog Interface 
Circuit 





(e) 






RCA Jack 




Analog Out 






If*. 


RCA Jack 




Analog In 






1 Idl 






o 



Plug your 
RS-232 cable 
into this socket 
(DB9 female) 



System Clock 



For schematics and more detail on the DSK board refer to Appendix A. 

5) Connect the 9-V AC transformer onto the DSK board. Refer to Figure 1 -2 
for details. 

6) Plug the transformer into a wall socket. 

7) Turn your PC's power on. 

i 1 

Note: 

Suitable RS232 Cables: 

□ DB9 Male connects to DB25 Female. 

□ DB9 Male connects to DB9 Female. 



1-5 



Step 2: Installing the DSK Software / Step 3: Modifying Your CONFIG.SYS File 



1.3 Step 2: Installing the DSK Software 

This section explains the process of installing the debugger software on a hard 
disk system. 

1 ) Make a backup copy of the product disk. (If necessary, refer to the DOS 
manual that came with your computer.) 

2) On your hard disk or system disk, create a directory named dsktools. This 
directory will contain the DSK assembler and debugger software. To 
create this directory, enter: 

md c:\dsktools (Z) 

3) Insert your product disk into drive A. Copy the contents of the disk: 

copy a:\*.* c :dsktools\* . * /v ® 



1.4 Step 3: Modifying Your CONFIG.SYS File 

When using the debugger, you can have only twenty files open or active at one 
time. To tell the system not to allow more than twenty active files, you must add 
the following line to your config.sys file: 

FILES-20 

Once you have edited your config.sys file and added the line, invoke the file 
by turning off the PC's power and turning it back on. 
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1.5 Step 4: Modifying the PATH Statement 

To ensure that your debugger works correctly, you must modify the PATH 
statement to identify the dsktools directory. Not only must you do this before 
you invoke the debugger for the first time, you must do it any time you power 
up or reboot your PC. 

You can accomplish this by entering individual DOS commands, but it's 
simpler to put the commands in your system's autoexec.bat file. The general 
format for doing this is: 

PATH-Cs \dsktools;path2;path3; . . . 

This allows you to invoke the debugger without specifying the name of the 
directory that contains the debugger executable file. 

If you are modifying your autoexec.bat file and it already contains a PATH 
statement, simply include ;C:\dsktools at the end of the statement as shown 
in Figure 1-3. 



Figure 1-3. DOS Command Setup for the DSK Environment (Sample autoexec.bat file) 



PATH statement 







-■"date 




TIME 




ECHO OFF 




PATH-c: \do 


s fc % \dsktools 


CLS 





If you modify the autoexec.bat file, be sure to invoke it before invoking the 
debugger for the first time. To invoke this file, enter: 

autoexec GE) 
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1.6 Step 5: Verifying the Installation 



To ensure that you have correctly installed your DSK board, the assembler, 
and the debugger, enter the following command at the system prompt: 



□ If you are using serial communication port 1 (COM1), enter: 
dskd el CS 

□ If you are using serial communication port 2 (COM2), enter: 

dskd c2 (2D 

Use d or c2 to identify the serial port that the debugger uses for communi- 
cating with your PC. The default setting is c1 . 

After entering the dskd command, you should see a display similar to this one: 





Display Fill Load Help eXec Quit Modify 



Op-ays Init Watch Reset Save Copy 



r— TMS320C26 Reverse Assembler 

ABSB CQCI H2EE HtfflC OPERANDS 



faff 

fbOO 
fbOl 
fb02 
fb03 
fb04 
fbOS 
fb06 
fb07 
fbOS 
fb09 
fbOa 



5500 
5588 
55«9 
55aa 
55ab 
6000 
6080 
6180 
6280 
6380 
608b 
618b 



NOP 

LARP 

MAR 

MAR 

MAR 

SACL 

SACL 

SACL 

SACL 

SACL 

SACL 

SACL 



AR0 
•+.AR1 
*+,AR2 
*+,AR3 
*r 

*,o 
*,1 

•,2 
*,3 

*,0,AR3 



TMS320C26 Watches 

10] hex (6100h) 
0000b - 00000000 



~=THS320C26 Display Data Mestoryi 'Hexadecimal' format : 



04001 ffOO 7£00 ffOO fdOO ffOO ffOO b7QO 

0407t ffOO efOO feOO ££28 ££00 ffOO 7f00 

040ei fb40 dfOO dfOO ffOO ffOO ffOO ffOO 

04151 ffOO 7d80 ffOO ffOO ffOO ffOO ffOO 

041CI £700 ffOO ffOO efOO dfOO ££00 ££00 




TMS320C26 Regiete 



ACCi 
CiO 
PRG: 
PMlO 
TRGl 
ST0>0 
DPI 
STlil 
ARP/B 
INTM: 
CNF I 
TCiO 
UMtl 
OVMl 
OVlO 

xni 

SXMl 
FOll 
FSMt 
TXMlO 
PCl 
STOt 
STll 
ST2I 



ffffff68 



0000 
600 
0000 
570 


1 
1 



1 
1 

fbOO AROiOOOt 
fa40 ARliffff 
0000 AR2i000C 
0000 AR3:£ff! 



□ If you see a display similar to this one, you have correctly installed your 
DSK board, the assembler, and the debugger. 

□ If you don't see a display, then your software or cables may not be installed 
properly. Go back through the installation instructions and be sure that you 
have followed each step correctly; then re-enter the command above. 



1-8 



' the DSK Assembler and Debugger 



Step 5: Verifying the Installation 



Installation errors 

If you still do not see a display, one of several of the following conditions may 
be the cause: 

□ Your baud setting may be incorrect. Some Windows and OS/2 applica- 
tions, as well as notebook computers, have low-level software limitations 
that may affect baud settings. Refer to page 5-2 for valid baud settings. 

□ You may have used an incorrect communication port (com1 vs. com 2). 
Refer to page 5-3 for more information on communication ports. 

□ Your communication port channel may be interrupted or noisy. If so, try 
using a lower baud. Refer to page 5-2 for valid bauds. 

□ A mouse driver or some other software may be using the same 
communication port you are attempting to use with the DSK. If so, try 
another communication port for the DSK. Refer to page 5-3 for more 
information on communication ports. 

□ Your RS232 cable and connectors may not be connected snugly. 

□ Your 9-V ac transformer may not be plugged in on both ends. If power is 
getting to the DSK, then the LM7805 voltage regulator will be warm to the 
touch. 



1-9 



Installing the DSK Assembler and Debugger 



Chapter 2 



Overview of a Code 
Development and Debugging System 

— — — — ~— — I,.,,.:,,,,,.— .,. —;, ,......ZZZZ 



The DSP Starter Kit (DSK) lets you experiment with and use a DSP for real- 
time signal processing. The DSK gives you the freedom to create your own 
software to run on the board as is or to build new boards and expand the 
system in any number of ways. 

The DSK assembler and debugger are software interfaces that help you to 
develop, test, and refine DSK assembly language programs. 

This chapter provides an overview of the assembler and debugger and 
describes the overall code development process. 



Topic Page 

2.1 Description of the DSK Assembler 2-2 

Key features of the assembler 2-2 

2.2 Description of the DSK Debugger 2-2 

Key features of the debugger 2-3 

2.3 Developing Code for the DSK 2-4 

2.4 Getting Started 2-5 
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2.1 Description of the DSK Assembler 

The DSK assembler is a simple and easy to use interface. Only the most 
significant features of an assembler have been incorporated. Note that this 
is not a COFF assembler; however, you can create object files by using the Tl 
TMS320 fixed-point DSP assembly language tools that will load and run on the 
DSK. 

Key features of the assembler 

Q Quick. The DSK assembler differs from many other assemblers in that it 
does not go through a linker phase to create an output file. Instead, the 
DSK uses special directives to assemble code at an absolute address 
during the assembly phase. As a result, you can create small programs 
quickly and easily. 

□ Easy-to-use. If you want to create larger programs, you can do this by 
simply chaining files together with the .include directive. 



2.2 Description of the DSK Debugger 

The debugger is easy to learn and use. Its friendly window- and menu-oriented 
interface reduces learning time and eliminates the need to memorize complex 
commands. The debugger is capable of loading and executing code with 
single-step, breakpoint, and run-time halt capabilities. 
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Description of the DSK Debugger 



Figure 2-1 identifies several features of the debugger display. When you 
invoke the debugger, you should see a display similar to this one (it may not 
be exactly the same, but it should be close). 



Figure 2-1. The Basic Debugger Display 
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MAR 


»+,AR3 


fb04 


6000 


SACL 


*,0 


fbOS 


6080 


SACL 


*.o 


fb06 


6180 


SACL 


*,1 


fb07 


6280 


SACL 


•,2 


fb08 


6380 


SACL 


«,3 


fb09 


608b 


SACL 


•,0,AR3 


fbOa 


618b 


SACL 


*,1,AR3 



TMS320C26 Watcbaa 



[0) hex (6100h) 
0000b - 00000000 



= THS320C26 Diaplay Data Maaoryi 'Hazadaciawl ' format: 



04001 ffOO 7f00 ffOO fdOO ffOO ffOO b700 . . 

0407: ffOO sf00 feOO ff28 ffOO ffOO 7f00 . . 

040e: fb40 dfOO d£00 ffOO f£00 ffOO ffOO « . 

0415: ffOO 7d8,0 ffOO ffOO ffOO ffOO ffOO . V 

041c: f700 ffOO ffOO af00 dfOO ffOO ffOO . . 



,XM«320C26 Raglatat 

ACC: ffffff68 
ClO 

PRSl 00000000 
PMlO 

TRS: 0000 
ST0 10600 
DP: 0000 
ST1 :1570 
ARP/B: 
»» » ll i> 

curi l 

TClO 
BMil 
OVM: 
OVtO 
XFll 
SXMl 1 
FOll 
FSMl 1 
TXMlO 

PC: fbOO AROlOOOO 
STOi fa40 ARliffff 
STll 0000 AR21O000 
ST2: 0000 AR3:ffff 



register 
display 



watch 
display 



Key features of the debugger 

□ Easy-to-use, window-oriented interface. The DSK debugger separates 
code, data, and commands into manageable portions. 

□ Powerful command set. Unlike many other debugging systems, this 
debugger doesn't force you to learn a large, intricate command set. The 
DSK debugger supports a small but powerful command set. 

□ Flexible command entry. There are two main ways to enter commands. 
You can enter commands at the command line or use the menu bar; 
choose the method that you like better. 
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"' 
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2.3 Developing Code for the DSK 

Figure 2-2 illustrates the DSK code development flow. 
Figure 2-2. DSK Software Development Flow 



assembler 
V J 



debugger 
' 



: 



Si; 



^assembler 

:fi source' 



assembler 



13 




The following list describes the tools shown in Figure 2-2. 

The assembler translates DSK assembly language source files into machine 
language object files for the TMS320C2x family of processors. Only the most 
essential features of an assembler have been incorporated. This is not a 
COFF assembler, although executable object files created by the Tl TMS320 
fixed-point DSP assembly language tools will also load and run on the DSK. 

The main purpose of the development process is to produce a module that can 
be executed in a DSK target system. You can use the debugger to refine and 
correct your code. 
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2.4 Getting Started 

This section provides a quick walkthrough so that you can get started without 
reading the whole user's guide. These examples show the most common 
methods for invoking the assembler and debugger. 

1 ) Create a short source file to use for the walkthrough; call it tryl .asm. 

******************************************************* 

* Saw— toothed Wave Generator * 

* Ramp rate is determined by interrupt * 

* rate and step size. Ramp is made by * 

* numerical rollover. * 
******************************************************* 

; Declare memory— mapped registers and program 



; block address 




DXR 


. set 


1 


; location of DXR register 


I MR 


. set 


4 


; location of IMR register 




.ps 


OfaOah 






B 


RINT 


;set receive interrupt vector 




.ps 


OfbOOh 






. entry 


; initial pc address 




LDPK 


DXR 


;load data page for DXR (zero) 




LAC 


I MR 






ORK 


OlOh 


;turn on receive interrupt RINT) 




SACL 


IMR 




LOOP: 


ADDK 


10 


; increment ACCU by 10 




SACL 


DXR, 3 


; shift ACCU left 3 bits when storing 




IDLE 




;wait for D/A interrupt 




B 


LOOP 




RINT: 


EINT 




; re— enable interrupts 




RET 






i 

Enter tl 




no comr 


nand to assemble tryl .asm: 



dska tryl ® 



This command invokes the TMS320C2x DSK assembler. If the input file 
extension is .asm (for example, tryl .asm), you don't have to specify the 
extension; the assembler uses .asm as the default. For more information 
about invoking the assembler, refer to Section 3.5. 

When you enter this command, the debugger creates an executable file 
called tryl .dsk. 

3) To see a listing of all errors and warnings that may have occurred during 
assembly of your program, assemble tryl .asm with the -I option (lower- 
case "L"). 

dska tryl -1 [S 
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4) This time, the assembler not only creates an executable file, it creates a 
listing file called tryl .1st. The listing file is helpful because it contains a list 
of all unresolved symbols and opcodes. 

DSKA => DSP Starter Kit Assembler Rev 1.00 Thu Feb 18 11:22:20 1993 Copyright 
© 1992-1993 Texas Instruments Incorporated 

0001 — **************************************************** 

0002 - * Saw-toothed Wave Generator * 

0003 — * Ramp rate is determined by interrupt * 

0004 - * rate and step size. Ramp is made by * 

0005 — * numerical rollover. * 

0006 — ******************************************************* 

0007 - ; Declare memory-mapped registers and program 



0008 






; block address 




0009 






DXR 


. set 


1 


; location of DXR register 


0010 






I MR 


.set 


4 


; location of IMR register 


0011 








. ps 


OfaOah 




0012 





faOa 


ff80 


B 


RINT 


;set receive interrupt vector 


0013 








.ps 


OfbOOh 


0014 








•entry 




; initial pc address 


»>» 


ENTRY POINT SET TO fbOO 






0015 





fbOO 


C800 


LDPK 


DXR 


;load data page for DXR (zero) 


0016 





fbOl 


2000 


LAC 


IMR 


0017 





fb02 




ORK 


OlOh 


;turn on receive interrupt RINT) 


0018 





fb04 




SACL 


IMR 




0019 





fb05 


LOOP: 


ADDK 


10 


; increment ACCU by 10 


0020 





fb06 




SACL 


DXR, 3 


; shift ACCU left 3 bits when storing 


0021 





fb07 




IDLE 




;wait for D/A interrupt 


0022 





fb08 




B 


LOOP 




0023 





fbOa 


RINT: 


EINT 




; re-enable interrupts 


0024 





fbOb 




RET 






»»> 


FINISHED 


READING ALL 


FILES 







»»> ASSEMBLY COMPLETE: ERRORS :0 WARNINGS :0 



5) Now you are ready to debug your program. Enter the following command 
to invoke the debugger: 

dskd (3D 

6) This command brings up the TMS320C2x DSK debugger on your screen. 
From here, you can load yourtryl .dsk sample program by using the LOAD 
menus. For more information on using the debugger, refer to Chapter 5. 
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3.1 Creating DSK Assembler Source Files 

To create a DSK assembler source file, you can use almost any ASCII program 
editor. Be careful using word processors; these files contain various formatting 
codes and special characters. 

DSK assembly language source programs consist of source statements that 
can contain assembler directives, assembly language instructions, and 
comments. Your source statement lines can be up to 80 characters per line. 



The next several lines show examples of source statements: 





.ps 


OfbOOh 


; initialize PC 


sym 


. set 


2 


; symbol sym=2 


Begin: 


addk 


sym 


; add sym (5) to accumulator 




• word 


016h 


; initialize a word with 016h 




sacl 


sym 


; store accumulator-location sym(5 


LAB 1: 








LAB 2: 


b 


LAB_1 




LAB 3: 


b 


LAB 2 


; location of LAB_1 & LAB_2 are sai 




b 


LAB 3 


;LAB_3 is at next address 



Your source statement can contain four ordered fields. The general syntax for 
source statements is as follows: 

[/abe/][:] mnemonic [operand list\ [; comment 



Follow these guidelines: 

□ All statements must begin with a label, a blank, an asterisk, or a semicolon. 

□ Labels are optional; if you use them, they must begin in column one. 

□ One or more blanks must separate each field. Note that tab characters are 
equivalent to blanks. 

□ Comments are optional. Comments that begin in column 1 can begin with 
an asterisk or a semicolon (* or ;), but comments that begin in any other 
column must begin with a semicolon. 
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Using valid labels 



Labels are optional for all assembly language instructions and for most (but 
not all) assembler directives. When you use them, a label must begin in col- 
umn 1 of a source statement. A label can contain up to 8 alphanumeric charac- 
ters (A-Z, a-z, 0-9, and _). Labels are case-sensitive, and the first character 
cannot be a number. For example: 

.ps OfbOOh ; Your code can start here 

.entry 

Start: larp 

lark AR0,0 

lack 03fh ; Turn on all interrupts 

ldpk ;IMR located in page 

sacl 4 ; store mask to I MR 

In the preceding example, the colon is optional. The DSK assembler does not 
require a label terminator. 

When you use a label, its value is the current value of the section program 
counter (the label points to the statement it's associated with). If, for example, 
you use the .word directive to initialize several words, a label would point to 
the first word. In the following example, the label Begin has the value OfbOOh. 



00001 *assume other code was assembled 

00002 

00003 .ps OfbOOh 

00004 fbOO 5588 Begin: .word 0Ah,3,7 

00005 fb0155a9 

When a label appears on a line by itself, it points to the instruction on the next 
line: 

00019 

00020 fbOO 5588 Here: 

00021 fbOl 55a9 .word 3 
00022 

When an opcode or directive references a label, the label is substituted with 
the address of the label's location in memory. The only exceptions to this are 
the .set directive, which assigns a value to a label, and the LDPK opcode, 
which loads the nine most significant bits (MSB) of the address. 

If you don't use a label, the first character position must contain a blank, a semi- 
colon, or an asterisk. 
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mm. ii l „ l a». l i l M. iii . I.. .J III .H. V i a i ii iiM i n i i ii m i i i nn*. in i mwm ■» . . ink *m*m , __. 

Using the mnemonic field 

The mnemonic field follows the label field. The mnemonic field cannot start in 
column 1, or it would be interpreted as a label. The mnemonic field can contain 
one of the following opcodes: 

□ Machine-instruction mnemonic (such as ADD, MPY, POP) 

□ Assembler directive (such as .data, .set, .entry) 

If you have a label in the first column, a space, colon, or tab must separate the 
mnemonic field (opcode) from the label. For example: 

• ps OfbOOh ; Your code can start here 
. entry 
START: larp 

lark ARO , 

lack 03fh ; Turn on all interrupts 

ldpk 

Refer to your TMS320C2x User's Guidelor syntax specifications on individual 
opcodes. 

It is generally necessary to resolve all fields in an opcode. If an opcode field 
(such as the shift field in a SACL opcode) is left out, the next field becomes the 
value for that particular field, and then the next field is not filled in. If you do not 
specify a field, its value is assumed to be null and is processed accordingly. 
For example: 

LDPK RESULT 
LAC RESULT 

WRONG: SACL *,AR7 ; becomes SACL *,7 (AR7 used for shift) 
RIGHT: SACL *,0,AR7 ;all fields are specified 

OK: SACL * 

In the above example, the numeric value of AR7 becomes 7. When this value 
is placed into the wrong field, the numeric value of AR7 becomes *BR0+. 

i 1 

Note: 

Not all improperly specified opcodes generate warnings. 
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Using the operand field 



The operand field is a list of operands that follow the mnemonic field. An 
operand can be a constant (see Section 3.2) or a symbol (see Section 3.3). 

The assembler allows you to specify that a constant, symbol, or expression 
should be used as an address, an immediate value, or an indirect value. The 
following rules apply to the operands of instructions. 

□ No prefix — the operand is a well-defined immediate value. The 

assembler expects a well-defined immediate value, such as a register 
symbol or a constant. This is an example of an instruction that uses oper- 
ands without prefixes: 

Label : ADD A3 

The assembler adds the contents of address A3 to the contents of the 
accumulator. 



□ * prefix — the operand is a register indirect address. If you use the* 
sign as a prefix, the assembler treats the operand as an indirect address; 
that is, it uses the operand as an address. For example: 

Label: ADD *+,AR3 

The following symbols are used in indirect addressing, including bit- 
reversed (BR) addressing: 

■ * The contents of AR are used as the data memory 

address. 

■ *+ The contents of AR are used as the data memory 

address and are incremented after the access. 

■ *- The contents of AR are used as the data memory 

address and are decremented after the access. 

■ *0+ The contents of AR are used as the data memory 

address, and the contents of INDX are added to it after 
the access. 

■ *0- The contents of AR are used as the data memory 

address, and the contents of INDX are subtracted from 
it after the access. 

■ *BR0+ The contents of AR are used as the data memory 

address, and the contents of ARO are added to it, with 
reverse carry (rc) propagation, after the access. 

■ *BR0- The contents of AR are used as the data memory 

address, and the contents of ARO are subtracted from 
it, with reverse carry (rc) propagation, after the access. 
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For more information on indirect addressing and bit-reversed addressing, 
refer to Memory Addressing Modes in the TMS320C2x User's Guide. 

Commenting your source file 

A comment can begin in any column and extends to the end of the source line. 
A comment can contain any ASCII character, including blanks. Comments are 
printed in the assembly source listing, but they do not affect the assembly. 

You can comment your source file in one of two ways. The most common way 
is to place a semicolon anywhere on the line you want to comment. All text 
placed after the semicolon is ignored by the DSK assembler. For example: 

; Your code can start here 

.ps OfbOOh 
.entry 
START: larp 

lark ARO , 

lack 03fh ; Turn on all interrupts 

ldpk 

Another way to comment your source file is to use an asterisk in the first col- 
umn of your code. 

* Your code can start here 

.ps OfbOOh 
. entry 
START: larp 

lark ARO , 

* Turn on all interrupts 

lack 03fh 
ldpk 

If the asterisk is not in the first column, the assembler assumes it is part of your 
code and may generate an error. 

A source statement that contains only a comment is valid. 
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3.2 Constants 



Decimal integers 



Hexadecimal integers 

A hexadecimal integer constant is a string of up to 8 hexadecimal digits 
followed by the suffix H (or h). Hexadecimal digits include the decimal values 
0-9 and the letters A-F or a-f . A hexadecimal constant must begin with a deci- 
mal value (0-9). These are examples of valid hexadecimal constants: 

78h Constant equal to 1 20i o or 0078i q 

OFh Constant equal to 1 5-| or OOOFi 6 

37ACh Constant equal to 1 4,252! or 37AC-| 6 

Binary integers 

A binary integer constant is a string of 0s and 1 s followed by the suffix B (or 
b). Examples of valid binary constants include: 

01 01 b Constant equal to 5 

1 01 01 b Constant equal to 21 

-01 01 b Constant equal to -5 

Character constants 

A character constant is a single character enclosed in double quotes. The 
characters are represented as 8-bit ASCII characters. 



The assembler supports four types of constants: 

□ Decimal integer constants 

□ Hexadecimal integer constants 

□ Binary integer constants 

□ Character constants 

The assembler maintains each constant internally as a 32-bit quantity. 
Constants are not sign extended. For example, the constant OFFh is equal 
to 00FF (base 16) or 255 (base 10); it does not equal -1 . 

A decimal integer constant is a string of decimal digits, ranging from 
-2,1 47,483,647 to 4,294,967,295. Examples of valid decimal constants are: 

1 000 Constant equal to 1 000i °r 3E8-| q 

-32768 Constant equal to -32,768-| or 8000-) e 

25 Constant equal to 25 1 or 1 9-| g 
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3.3 Symbols 



Labels 



Constants 



Symbols are used as labels, constants, and substitution symbols. A symbol 
name is a string of up to 8 alphanumeric characters (A-Z, a-z, 0-9, $, -, and 
+) ; symbols cannot contain embedded blanks. The first character in a symbol 
cannot be a number or special character. The symbols you define are case 
sensitive; for example, the assembler recognizes ABC, Abe, and abc as three 
unique symbols. 



Symbols that are used as labels become symbolic addresses that are 
associated with locations in the program. A label must be unique. 



Symbols can be set to constant values. By using constants, you can equate 
meaningful names with constant values. The .set directive enables you to set 
constants to symbolic names. Symbolic constants cannot be redefined. The 
following example shows how these directives can be used: 



K 

K*2 

BIN 

max buf 



. ps 
. set 

• set 
. set 

• set 
lack 
lack 
lack 
lack 
lack 
lack 



OfbOOh ; initialize PC 

12 ; constant definition K=12 

24 ; constant definition K*2=24 

01010101b ;BIN = 055h 

K*2 ;max_buf = K*2 = 24 

K ; loads 12 

— K 'loads -12 

K*2 ; loads 24 

2*K ; assumes constant, loads 2 

max_buf ; loads 24 

I BIN ; loads OAAh 
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3.4 Using Symbols as Expressions 

Unlike other assemblers, the DSK assembler is not capable of analyzing 
numerical or logical expressions. However, by removing all of the spaces with- 
in a field so that the expression is a continuous string, you can set the entire 
string to a specific value (see Figure 3-1). 

Figure 3-1. Analyzing Expressions With the DSK Using Continuous Strings 

(a) Expression Analysis With a COFF Assembler 
FFT .set 256 

LRLK ARO , FFT 

LALK FFT —1 ; expression analysis 

(b) Expression Analysis With the DSK Assembler 
FFT .set 256 

FFT— 1 .set 255 ;set string FFT— 1 = 255 

LARK ARO, FFT 

LALK FFT— 1 ;FFT-1 is a complete string 

In Figure 3-1 (b) , FFT-1 is a continuous string. The .set directive equates the 
value 256 to the symbol FFT and 255 to the symbol FFT-1 ; these symbols can 
now be used in place of their values. The two opcodes now contain the follow- 
ing: 

LARK ARO, 256 
LALK 255 
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3.5 Assembling Your Program 

Before you attempt to debug your programs, you must first assemble them. 
Here's the command for invoking the assembler when preparing a program for 
debugging: 




dska is the command that invokes the assembler. 

filenames are one or more assembly language source files. Filenames are 
not case sensitive. 

-options affect the way the assembler processes input files. 

Options and filenames can be specified in any order on the command line. 

Table 3-1 lists the assembler options; the following subsections describe the 
options. 

Table 3-1. Summary of Assembler Options 



Option 


Brief description 


-k 


Generates an output file, regardless of errors or warnings 


-I 


Generates a temporary file containing a list of any unresolved 




opcodes or symbols 


-d 


Disassembles the output file as it is created (for debugging 




purposes) 


asm 


Allows you to define assembler statements from the command line 



Generating an output file (-k option) 

By default, the DSK deletes a file corrupted with errors. For debugging 
purposes, the -k option tells the DSK assembler to generate an output file, 
despite any errors or warnings found. 
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Your Program 



Creating a temporary object file (-1 option) 

The DSK assembler can generate an intermediate listing file containing all un- 
resolved opcodes when you use the -I (Lowercase T") option. For example, 
if you want to assemble a file named test.dsk and create a listing file, enter: 

dska test -1 

The above example creates the file test.lst from the file test.asm. Any 
unresolved symbols are resolved after the DSK assembler has read the entire 
assembly file. 



Disassembling the output file (-d option) 

The disassemble option is most useful when you are trying to find recurring 
bugs. As the output file is created, a disassembler disassembles the file. Once 
the file is disassembled, all opcodes contain resolved symbols; therefore, the 
assembler assigns an absolute value or address to each symbol. 



Defining assembler statements from the command line (asm option) 

The asm option allows you to define assembler statements from the command 
line. Since the DSK does not have a linker, using the asm option allows you 
to specify constants and load addresses. The general format for this option is: 

dska filename asm" statement" [ asm" statement" ] 

For example: 

dska test.asm asm"FFT .set 256" asm" .entry OfbOOfa" 

This statement specifies a program entry point (or load address) of OfbOOh and 
generates the file test.inc, in the following format: 

FFT . SET 256 
.entry OfbOOh 



All asm statements are written to an include file named file.inc, overwriting the 
previous file. 

The asm statement is also useful for controlling parameter values such as .set, 
or controlling conditional assembler execution by using such directives as the 
.if/.else/.endif. 

dska test.asm asm"fft .set 256" 



In this example, the asm statement is assigning a value of 256 to the symbol 
fft. 
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Assembler Directives 



Assembler directives supply program data and control the assembly process. 
They allow you to do the following: 

□ Assemble code and data into specified sections 

□ Reserve space in memory for uninitialized variables 

□ Control the appearance of listings 

□ Initialize memory 

□ Assemble conditional blocks 

□ Define global variables 



Topic 



Page 



4.1 Using the DSK Assembler Directives 

4.2 Directives That Define Sections 

4.3 Directives That Reference Other Files 

4.4 Conditional Assembly Directives 

4.5 Directives That initialize Memory 

4.6 Miscellaneous Directives 

4.7 Directives Reference 
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4.1 Using the DSK Assembler Directives 

Table 4-1 summarizes the assembler directives. Note that all source 
statements that contain a directive may have a label and a comment. To 
improve readability, they are not shown as part of the directive syntax. 



Table 4-1. Assembler Directives Summary 



Directives That Define Sections 



Mnemonic and Syntax Description 



.data Assemble into data memory 

.ds [address] Assemble into data memory (initialize data address) 

.entry [address] Initialize the starting address of the program counter 

when loading a file 

.ps [address] Assemble into program memory (initialize program 

address) 

.text Assemble into program memory 



Directives That Reference Other Files 



Mnemonic and Syntax Description 



.copy ["[filename^ Include source statements from another file 

.Include [°]filename['] Include source statements from another file 



Conditional Assembly Directives 



Mnemonic and Syntax 



.else 
.endif 

.If well-defined expression 



Optional conditional assembly 
End conditional assembly 
Begin conditional assembly 
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Table 4-1. Assembler Directives Summary (Continued) 



Directives That Initialize Constants (Data and Memory) 



Mnemonic and Syntax 



Description 



.bfloat value-! [,..., value n ] 

.byte value-t [,..., valued 
.double value-t [,..., valued 
.efloat value-/ [.-. value n ] 

.float va/ue ? [,..., value n ] 

.int value-! [,..., value n ] 
.long value-! I—, valuen] 
.Iqxx value-i [•■■-. valued 

.qxx valuer [.•••» valued 

.space size in bits 

.string "string!^,..., "string n "\ 
.tfloat value-i [>— . value n ] 

.word wa/t/ey [,..., value n ] 



Initialize a 16-bit, 2s-complement exponent and a 
32-bit, 2s-complement mantissa — an unpacked 
floating-point number 

Initialize one or more successive words in the current 
section 

Initialize a 64-bit, IEEE double-precision, floating- 



Initialize a 16-bit, 2s-complement exponent and a 
16-bit, 2s-complement mantissa— a less accurate 
unpacked floating-point number 

Initialize a 32-bit, IEEE single-precision, floating-point 
constant 

Initialize one or more 16-bit integers 

Initialize one or more 32-bit integers 

Initialize a 32-bit, signed 2s-complement integer 
whose decimal point is displaced xx places from the 
LSB 

Initialize a 16-bit, signed 2s-complement integer 
whose decimal point is displaced xx places from the 



Reserve size bits in the current section; note that a 
label points to the beginning of the reserved space 

Initialize one or more text strings 

Initialize a 32-bit, 2s-complement exponent and a 
64-bit, 2s-complement mantissa; note that the initial- 
ized integers are in unpacked form 

Initialize one or more 16-bit integers 



Miscellaneous Directives 



Mnemonic and Syntax Description 



.end Program end 

.listoff End source listing (overrides the -I assembler option) 

.liston Restart the source listing (overrides the -I assembler 

option) 

.set Equate a value with a local symbol 
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4.2 Directives That Define Sections 

Five directives associate the various portions of an assembly language 
program with the appropriate sections: 

□ .data identifies portions of code to be placed in data memory. Data 
memory usually contains initialized data. 

□ .ds functions the same as .data, however, with the .ds directive you can 
specify an optional address to initialize a new data address. 

□ .entry identifies the starting address of the program counter. By default, 
the current address is used, or, you can specify an optional address. 

□ .ps identifies portions of code to be placed in program memory. With the 
.ps directive you can specify an additional address to initialize a new pro- 
gram address. 

□ .text identifies portions of code in the .text section. The .text section 
usually contains executable code. 

Example 4-1 shows how you can use sections directives to associate code 
and data with the proper sections. This is an output listing; column 1 shows line 
numbers, and column 2 shows the SPC values. (Each section has its own 
section program counter, or SPC.) When code is first placed in a section, its 
SPC equals 0. When you resume assembling into a section, its SPC resumes 
counting as if there had been no intervening code. 

After the code in Example 4-1 is assembled, the sections contain: 

.text Initializes bytes with the values 1 , 2, 3, 4, 5, and 6 

.data Initializes bytes with the values 9,10,11, and 1 2 
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Example 4-1. Sections Directives 



1 
X 






********************************* 


2 
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5 
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********************************* 
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* Star"t assembling into .text * 


9 
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. text 


1 1 
1 X 
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• uyte If Z 
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fun a 

too u 


a a a i 
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X J. 


IDUU X 
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1 o 
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xz 
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0004 
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********************************* 
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14 








Id 






. data 


16 






. byte 9,10 




A A 

tcuu 


a a a o 




X 


xcu X 


A A A a 

uuua 




17 






.byte 11,12 


1 *7 
1 / 


rcUz 


A A AW 




17 


fc03 


000c 




18 






********************************* 


19 






* Resume assembling into .text * 


20 






********************************* 


21 






• text 


22 






.byte 5,6 


22 


fb04 


0005 




23 


fb05 


0006 




»»> 


FINISHED READING ALL FILES 


»»ASSEMBLY 


COMPLETE: ERRORS : WARNINGS :0 



I 1 

Note: 

You can use the .ps and .ds directives to assemble your code to the same 
memory locations. This won't cause an assembly error; however, it is pos- 
sible to overwrite previously defined memory blocks, 
i 1 
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4.3 Directives That Reference Other Files 



The .copy and .include directives tell the assembler to read source state- 
ments from another file. This is the syntax for these directives: 

.copy [']filename['] 
.include [']filename['] 



The filename names a copy/include file that the assembler reads statements 
from. The filename can be a complete pathname, a partial pathname, or a file- 
name with no path information. The assembler searches for the file in the 
directory that contains the current source file. The current source file is the file 
being assembled when the .copy or .include directive is encountered. 

The .copy and .include directives tell the assembler to begin reading source 
statements from another file. When the assembler finishes reading the source 
statements in the copy/include file, it resumes reading source statements from 
the current file. The statements read from the copied or included files are 
printed in the listing file. 
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4.4 Conditional Assembly Directives 

The .if/.else/.endif directives tell the assembler to conditionally assemble a 
block of code according to the evaluation of an expression. Note that you 
cannot nest if statements. 

.if expression Marks the beginning of a conditional block and 
assembles code if the .if condition is true (not zero) . 

.else Marks a block of code to be assembled if .if is false. 

.endif Marks the end of a conditional block and terminates 

the block. 

The expression parameter can be either a numeric value or a previously 
defined symbol. 
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4.5 Directives That Initialize Memory 

Each of these directives, with the exception of the .byte and .string directives, 
aligns the object to a 1 6-bit word boundary. 

□ .byte places one or more 8-bit values into consecutive words of the current 
section. 

□ .word places one or more 1 6-bit values into consecutive words in the 
current section. 

□ .string places 8-bit characters from one or more character strings into the 
current section. 

□ .long places one or more 32-bit values into consecutive 32-bit fields in the 
current section. 

□ .int places one or more 1 6-bit values into consecutive words in the current 
section. 

□ .qxx places one or more 16-bit, signed 2s-complement values into 
consecutive words in the current section. Note that the decimal point is 
displaced xx places from the LSB. 

□ .Iqxx places one or more 32-bit, signed 2s-complement values into 
consecutive 32-bit fields in the current section. Note that the decimal point 
is displaced xx places from the LSB. 

□ .float calculates 32-bit IEEE floating-point representations of single preci- 
sion floating-point value and stores it in two consecutive words in the 
current section. 

□ .bf loat calculates a 1 6-bit, signed 2s-complement exponent and a 32-bit, 
signed 2s-complement mantissa. 

□ .ef loat calculates a 1 6-bit, signed 2s-complement exponent and a 1 6-bit, 
signed 2s-complement mantissa. 

□ .tfloat calculates a 32-bit, signed 2s-complement exponent and a 64-bit, 
signed 2s-complement mantissa. 

□ .double calculates a 64-bit IEEE floating-point representation of a double 
precision floating-point value and stores it in four consecutive words in the 
current section. 
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□ The .space directive reserves a specified number of bits in the current 
section. The assembler advances the SPC and skips the reserved words. 

When you use a label with .space, it points to the first word of the reserved 



Example 4-2 shows an example of the .space directives. Assume the 
following code has been assembled for this example: 



RES 1: 



.ps 
.word 
.space 
.word 



OfbOOh 
lOOh, 200h 
30h 
15 



; Reserve 48 bits or 3 words 



Res_1 points to the first byte in the space reserved by .space. 
Example 4-2. The .space Directive 



17 bytes 
reserved 



{ 



Res 1 = 30h 



4.6 Miscellaneous Directives 

This section discusses miscellaneous directives. 

□ The .end directive terminates assembly. It should be the last source state- 
ment of a program. This directive has the same effect as an end-of-file. 

□ The .listoff directive overrides the -I option and prohibits source listing. 

□ The .liston directive begins source listing. 

□ The .set directive equates meaningful symbol names to constant values 
or strings. The symbol is stored in the symbol table and cannot be 
redefined; for example: 

bval .set OlOOh 
•byte bval 
jmp bval 
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4.7 Directives Reference 

The remainder of this chapter is a reference. Generally, the directives are 
organized alphabetically, one directive per page; however, related directives 
(such as .if/.else/.endif) are presented together on one page. Here's an 
alphabetical table of contents for the directive reference: 



Directive Page 

.bfloat 4-17 

.byte 4-11 

.copy 4-12 

.data 4-14 

.double 4-17 

.ds 4-14 

.efloat 4-17 

.else 4-19 

.end 4-15 

.endif 4-19 

.entry 4-16 

.float 4-17 

.if 4-19 

.include 4-12 

.int 4-29 

.listoff 4-20 

.liston 4-20 

.long 4-22 

.Iqxx 4-23 

.ps 4-27 

.qxx 4-23 

.set 4-24 

.space 4-25 

.string 4-11 

.text 4-27 

.tfloat 4-17 

.word 4-29 
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Syntax 
Description 



Example 



.byte value-i [,,.., value n ] 

.string Str^ [, ... , String 

The .byte and .string directives place one or more 8-bit values into consecutive 
bytes of the current section. A value can be either: 

□ An expression that the assembler evaluates and treats as an 8-bit signed 
number, or 

□ A character string enclosed in double quotes. Each character in a string 
represents a separate value. 

Unlike the .byte directive, the .string directive places the 8-bit values into 
memory in a packed form in the order they are encountered. If a word is not 
filled, the remaining bits i 



This example shows several 8-bit values placed into consecutive bytes in 
memory. The label strx has the value Oh, which is the location of the first initial- 
ized byte. The label stry has the value 6h, which is the first byte initialized by 
the .string directive. 



0001 






0002 






0002 


fbOO 


000a 


0002 


fbOl 


OOff 


0002 


fb02 


0002 


0002 


fb03 


000a 


0002 


fb04 


0061 


0002 


fb05 


0062 


0002 


fb06 


0063 


0003 






0003 


fb07 


Oaff 


0003 


fb08 


020a 


0003 


fb09 


6162 


0003 


fbOa 


6300 



strx: 



.ps OfbOOh 

.byte 10,-1, 2, OAh, "abc' 



stry: 



.string 



10, -1,2, OAh, "abc" 



In the above example, "abc" is converted into three ASCII characters. 



4-11 



Directives Reference 



Syntax 



Description 



copy "filename" 



Example2 




.indue 

(The quote marks enclosing the filename are optional.) 



"filename" 

i 111 



The .copy and .include directives tell the assembler to read source statements 
from a different file. The assembler: 

1) Stops assembling statements in the current source file. 

2) Assembles the statements in the copied/included file. 

3) Resumes assembling statements in the main source file, starting with the 
statement that follows the .copy or .include directive. 

The filename is a required parameter that names a source file; the filename 
must be enclosed in double quotes and must follow operating system conven- 
tions. You can specify a full pathname (for example, c:\dsktools\file1.asm). If 
you do not specify a full pathname, the assembler searches for the file in the 
current directory. 

The statements that are assembled from an included file are printed in the as- 
sembly listing, depending on the .liston/.listoff directives and -I option. 

The .copy and .include directives can be nested within a file being copied or 
included. The assembler limits this type of nesting to eight levels; the host op- 
erating system may set additional restrictions. 

This example shows how the .include directive is used to tell the assembler 
to read and assemble source statements from other files, then to resume as- 
sembling into the current file. 

Source file: (source.asm) 



. space 
.include 



lOh 

"byte. asm" 



.space 2 Oh 

First copy file: (byte.asm) 



.byte 
. include 
• byte 



'a', Oah, 32 
"word. asm" 

11,12,13 



Second copy file: (word.asm) 

.word Oabcdh, 56 



Filename: source.asm 

Filename: source.asm 

Filename: source.asm 

Filename: source.asm 

Filename: source.asm 



Filename: byte.asm 

Filename: byte.asm 

Filename: byte.asm 

Filename: byte.asm 

Filename: byte.asm 



Filename: word.asm 
Filename: word.asm 
Filename: word.asm 
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Listing file: 

0001 ; filename: source. asm 

0002 .space lOh ; filename: source. asm 

0003 .include "byte. asm" ; filename: source. asm 

************************************************** 

* OPENING INCLUDE FILE byte. asm 
************************************************** 

0001 ; filename: byte. asm 

0002 .byte 'a',0ah,32 ; filename: byte. asm 

0002 0001 0061 

0002 0002 000a 

0002 0003 0020 

0003 .include "word. asm" ; filename: byte. asm 

************************************************** 

* OPENING INCLUDE FILE word. asm 
************************************************** 

0001 ; filename: word. asm 

0002 .word 0abcdh,56 ;filename: word. asm 

0002 0004 abed 

0002 00005 0038 

0003 

************************************************** 

* CLOSING FILE 

************************************************** 

.byte 11,12,13 ; filename: byte. asm 



; filename: byte . asm 



0004 






0004 


0006 


000b 


0004 


0007 


000c 


0004 


0008 


OOOd 


0005 







************************************************** 
* CLOSING FILE 

************************************************** 

0004 ; filename: source. asm 

0005 .space 20h ; filename: source. asm 

»»> FINISHED READING ALL FILES 

»»> ASSEMBLY COMPLETE: ERRORS: WARNINGS: 
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Syntax 




Description The .data and .ds directives tell the assembler to begin assembling source 

code into data memory. The .data and .ds sections are normally used to con- 
tain tables of data or preinitialized variables. 

The address is an optional parameter that specifies a 1 6-bit address. Normally, 
the section program counter is set to the first time the .data or .ds section is 
assembled; you can use this parameter to assign an initial value to the SPC. 

Note that the assembler assumes that .text is the default section. Therefore, 
at the beginning of an assembly, the assembler assembles code into the .text 
section unless you specify a section control directive. 

Example This example shows the assembly of code into the .data and .text sections. 





.ps 


OfbOOh ;set up load and run address' 




.entry 






.include 


"VECT.ASM" 




.ds 


0400h 




.text 




setup: 


larp 


ARO ; initialize the CPU registers 




lark 


AR0,0 




lark 


AR1,0 




lark 


AR2,0 




lark 


AR3,0 




• data 




val_l : 


. int 


0,1,2,3,4,5,6,7 ;init. integer values 




.text 


; continue with some code 


loop: 


mar 


*+,ARl 




mar 


*+,AR2 




mar 


*+,AR3 




b 


loop, *+, ARO 




.data 




val_2 : 


.float 0, 


1,2,3,4,5,6,7 ;init. flt-pt values 
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Syntax 
Description 

Example 




The .end directive is an optional directive that terminates assembly. It should 
be the last source statement of a program. The assembler ignores any source 
statements that follow an .end directive. 



.end directive terminates assembly. 



OFBOOh 




START 



LAB 



.ps 

. entry 

NOP 

NOP 



B 



START 



.end ; these lines are ignored 

5 



sub 
B 



1 



Listing file: 

0001 

0002 

»»> ENTRY POINT SET TO fbOO 



0003 

0004 

0005 

0006 
0007 

»»> LINE 



fbOl 
fb02 
fb03 



5500 
5500 
5500 
ff80 



START 



• ps 

.entry 

NOP 
NOP 
NOP 
B 

.end 



OFBOOh 



START 



.END ENCOUNTERED 



»»> FINISHED READING ALL FILES 

»»> ASSEMBLY COMPLETE: ERRORS : WARNINGS : 
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Syntax 
Description 




Example 



The .entry directive tells the assembler the address of the program counter 
when a file is loaded. If you do not use the value parameter, the current 
program memory address, determined by the .ps or .text section, becomes the 
starting address. If you have more than one .entry directive in your file, then 
the last .entry directive encountered becomes the starting address of your 
code. 

Here is an example of the .entry directive. 



LOOP: 



.ps 


OfbOOh 




MAR 


*+,ARl 


;An infinite loop 


B 


LOOP,*+,AR0 


• 

i 


. entry 




; Start program 


LARP 


ARO 




LARK 


AR0,0 




LARK 


AR1,0 




B 


LOOP 


;call the routine 
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Syntax 



Description 





value [,..., 


vwue ;: ] : : 


rr ■ . ■ ■ ■ 


' 


value [,.. 








... va/ufni 




.efloat 


value [,.. 


. va!ue r ) 






value [,... 


value : 





The .float directive places the floating-point representation of a single floating- 
point constant into two words in the current section. The value must be a 
floating-point constant. Each constant is converted to a floating-point value in 
32-bit IEEE floating-point format. 

The IEEE floating-point format consists of three fields: 

□ A 1 -bit sign field (s) 

□ An 8-bit biased exponent (exponent) 

□ A 23-bit normalized mantissa (mantissa) 

15 14 7 6 



exponent 



15 



.bfloat 



< 



The .bfloat directive format is slightly different in that it has a 1 6-bit exponent 
and both a high and low mantissa: 



.efloat 




15 









: ma/?ftssa (high)": 




15 














Example 



Source file: 



.ds 0400h 

.bfloat 1.5,3,6 

.bfloat -1.5,3,6 

.efloat 1.5,3,6 
.end 



4-17 



Directives Reference 



Listing file: 

0001 - .ds 0400h 

0002 - .bfloat 1.5,3,6 

0002 1 0400 0000 

0002 1 0401 6000 

0002 1 0402 0000 

0002 1 0403 0000 

0002 1 0404 6000 

0002 1 0405 0001 

0002 1 0406 0000 

0002 1 0407 6000 

0002 1 0408 0002 

0003 - .bfloat -1.5,3,6 

0003 1 0409 0000 

0003 1 040a aOOO 

0003 1 040b 0000 

0003 1 040c 0000 

0003 1 040d 6000 

0003 1 040e 0001 

0003 1 040f 0000 

0003 1 0410 6000 

0003 1 0411 0002 

0004 - .efloat 1.5,3,6 

0004 1 0412 6000 

0004 1 0413 0000 

0004 1 0414 6000 

0004 1 0415 0001 

0004 1 0416 6000 

0004 1 0417 0002 

0005 - 

»»> LINE 5: .END ENCOUNTERED 
»»> FINISHED READING ALL FILES 

»»> ASSEMBLY COMPLETE: ERRORS : WARNINGS : 
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Syntax 



Description 



Example 



.if well-defined expression 

code block to execute when the expression is true 
.else 

code to assemble when the expression is false 
.endif 

- terminate condition block 
iree directives provide conditional assembly: 

□ The .if directive marks the beginning of a conditional block. The 
expression is a required parameter. 

■ If the expression evaluates to true (nonzero), the assembler 
assembles the code that follows it (up to an .else, or an .endif). 

■ If the expression evaluates to false (0), the assembler assembles 
code that follows an .else (if present), or an .endif. 

□ The .else directive identifies a block of code that the assembler assembles 
when the .if expression is false (0). This directive is optional in the 
conditional block; if an expression is false and there is no .else statement, 
the assembler continues with the code that follows the .endif. 

□ The .endif directive terminates a conditional block. 
Nested .if/.else/.end directives are not valid. 

Here are some examples of conditional assembly: 



yes 


.set 


1 


no 


• set 





B0_Dat 


. set 


no 


Bl_Dat 


. set 


yes 


If_l: 


.if 


B0_Dat 




.da 


0200h 




.endif 






.if 


Bl_Dat 




. ds 


0400h 


If 2: 


.endif 





Note: 

In this instance, the asm option can be particularly useful in turning on the 
.if conditional statement from the command line. For example, you could 
enter: 

dska test asm"B0_Dat .set 1" 

i i 
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Syntax 


.listen 











Description The .liston and .listoff directives can be useful in debugging your code. They 

override the -I assembler option, which turns on the output listing. The source 
listing is always written to a file with an extension of .1st. 

Example Here's an example of a source file and its output listing file. 

Source file: 

*************************************** 

* .liston/off example 

*************************************** 



.ds 0400h 
.listoff 

DATA .word 1,2,3,4,5 ;Do not want this listed 1 

.liston ;Note this line isn't listed 

•ps OfbOOh 

lalk PROG 

lrlk ARO , DATA 

rptk 3 ;move 4 words from DS to PS 

tblw *+ 
loop nop 

b loop 

.word 0,0,0,0 
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Listing file: 



0001 


— 






**************************************** 


0002 


— 






* 


.LISTON/OFF EXAMPLE 


0003 


— 






*************************************** 


0004 


— 








.ds 


0400h 


0005 










. listof f 


0008 


— 








.ps 


ofbooh 


0009 





fbOO 


dOOl 




lalk 


PROG 


0010 





fb02 


dOOO 




lrlk 


AR0,DATA 


0011 





fb04 


cb03 




rptk 


3 ;move 4 words from 


0012 





fb05 


59a0 




tblw 


*+ 


0013 





fb06 


5500 


loop 


nop 




0014 





fb07 


ff80 




b 


loop 


0015 








PROG: 


.word 


0,0,0,0 


0015 





fb09 


0000 






0015 





fbOa 


0000 








0015 





fbOb 


0000 








0015 





fbOc 


0000 








»»> 


FINISHED READING ALL FILES 






>»» 


ASSEMBLY COMPLETE: 


ERRORS : 


WARNINGS: 
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Syntax 
Description 



.long value t [, ... , value n ] 



Example 




The .long directive places one or more 32-bit values into consecutive words 
of the current section. A value can be either: 

□ An expression that the assembler evaluates and treats as a 32-bit signed 
number, or 

□ A character string enclosed in double quotes. Each character in a string 
represents a separate value. 

If you use a label, it points to the location at which the assembler places the 
first byte. 

This example shows several 32-bit values placed into consecutive bytes in 
memory. The label strx has the value OFBOOh, which is the location of the first 
initialized byte. 






fbOO 


2710 





fbOl 


0000 





fb02 


0053 





fb03 


0000 





fb04 


0074 





fb05 


0000 





fb06 


0072 





fb07 


0000 





fb08 


0069 





fb09 


0000 





fbOa 


006a 





fbOb 


0000 





fbOc 


0067 





fbOd 


0000 





fbOe 


0041 





fbOf 


0000 



•ps OfbOOh 
strx: .long 10000 , "String" , 'A' 



0001 
0002 
0002 
0002 
0002 
0002 
0002 
0002 
0002 
0002 
0002 
0002 
0002 
0002 
0002 
0002 
0002 
0002 



»»> FINISHED READING ALL FILES 

»»> ASSEMBLY COMPLETE: ERRORS: WARNINGS: 
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Syntax 



Description 



.Iqxx vaiue-j [, ... , value n ] 
.qxx valuei [,..., value n ) 

The .qxx and .Iqxx directives generate signed, 2s-complement fractional inte- 
gers and long integers whose decimal point is displaced xx places from the 
LSB. 



Example 

0001 
0002 
0002 
0003 
0003 
0004 
0004 
0005 
0005 
0005 
0005 
0006 
0006 
0006 
0006 
0006 

»»> FINISHED READING ALL FILES 



Here's an example of the .qxx directive. 



1 


0400 


2000 


1 


0401 


4000 


1 


0402 


6000 


1 


0403 


eOOO 


1 


0404 


C000 


1 


0405 


aOOO 


1 


0406 


0000 


1 


0407 


0900 


1 


0408 


0000 


1 


0409 


OaOO 



.ds 
.Q15 

• Q15 

.Q15 

.Q15 



0x400 
0.25 

0.5 

0.75 

-0.25,-0.5,-0.75 



l<— 15 Pi — >| 
0.010000000000000b 



.LQ24 9,10 



»»> ASSEMBLY COMPLETE: ERRORS : WARNINGS :0 
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Syntax 
Description 



Example 



Result 



symbol .set value 



.-. :■. 

The .set directive equates a constant value to a symbol. The symbol can then 
be used in place of a value in assembly source. This allows you to equate 

□ The symbol must appear in the label field. 

□ The value must be a well-defined expression; that is, all symbols in the ex- 
pression must be previously defined in the current source module. 

This example shows how symbols can be assigned with .set. 



zero 
zero+1 



.set 
• set 
LACK 
ADDK 




1 

zero 
zero+1 



; zero+1 is a symbol 
; zero+1 is replaced 
; symbol 



LACK 
ADDK 1 
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Syntax .space size in bits 

Description The .space directive reserves size number of bits in the current section, the 

SPC is incremented to point to the word following the reserved space. 

When you use a label with the .space directive, it points to the first word re- 
served. 

Example This example shows how the .space directive reserves memory. 

Source file: 

************************************ 

* Begin assembling into .text 
************************************ 

.text 

************************************ 

* Reserve 15 words in .text 
************************************ 

•space OfOh 
.word lOOh, 200h 

************************************ 

* Begin assembling into .data 
************************************ 

• data 

.string ".data" 
******************************************* 

* Reserve 2 words in .data; 

* Res_l points to the first reserved word 
******************************************* 

.space 020h 
.word 15 
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Listing file: 



OOOf 0100 
0010 0200 



0000 2e64 

0001 6174 

0002 6100 



1 0005 OOOf 



.space 
• word 



0001 
0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
0009 
0009 
0010 
0011 
0012 
0013 
0014 
0015 
0016 
0016 
0016 
0016 
0017 
0018 
0019 
0020 
0021 
0022 
0023 

0024 
0025 
0026 
0026 

0027 - 

»»> FINISHED READING ALL FILES 



********************************** 

* Begin assembling into .text 
********************************** 

* text 

*********************************** 

* Reserve 15 words in .text 
********************************** 



OfOh 

100h,200h 



********************************** 

* Begin assembling into .data 
********************************** 

.data 

.string ".data" 



*********************************** 

* Reserve 2 words in .data 

* Res_l points to the 1st reserved 
word 

*********************************** 



.space 
.word 



020h 
15 



»»> ASSEMBLY COMPLETE: ERRORS : WARNINGS :0 
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Syntax 


.text 






.ps [address] 





Description The .text and .ps directives tell the assembler to begin assembling into the .text 

or .ps sections (program memory), which usually contain executable code. 
The section program counter is set to if nothing has yet been assembled into 
the .text or .ps sections. If code has already been assembled into the respec- 
tive section, the section program counter is restored to its previous value in the 
section. 

The address is an optional parameter for the .ps directive that specifies a 1 6-bit 
address. This address sets the initial value of the SPC. If no address is speci- 
fied, a default value of is used. 

Note that the assembler assumes that .text is the default section. Therefore, 
at the beginning of an assembly, the assembler assembles code into the .text 
section unless you specify one of the other sections directives (.data, .ps, .ds, 
.entry). 
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Example This example shows code assembled into the .text and .data sections. The 

.data section contains integer constants, and the .text section contains charac- 
ter strings. 

0001 ********************************** 

0002 * Begin assembling into .data 

0003 *********************************** 

0004 .ds OfbOOh 

0005 .byte 5,6 

0005 fbOO 0005 

0005 fbOl 0006 

0006 *********************************** 

0007 * Begin assembling into .ps 

0008 *********************************** 

0009 .ps 7000h 

0010 .byte 1 

0010 7000 0001 

0011 .byte 2,3 

0011 7001 0002 

0011 7002 0003 

0012 *********************************** 

0013 * Resume assembling into .data 

0014 *********************************** 

0015 .data 

0016 .byte 7,8 

0016 fb02 0007 

0016 fb03 0008 

0017 *********************************** 

0018 * Resume assembling into .ps 

0019 *********************************** 

0020 .ps 

0021 .byte 4 

0021 7003 0004 



»»> FINISHED READING ALL FILES 

»>» ASSEMBLY COMPLETE : ERRORS : WARNINGS : 



4-28 



Assembler Directives 



Directives Reference 



Syntax 



Description 



Examplel 



Example2 



.word value-i [,..., valuer,] 
n1 i alue n ] 

f -< - 

The .int and .word directives place one or more 1 6-bit values into consecutive 
words in the current section. 

The values must be absolute. You can use as many values as fit on a single 
line (80 characters) . If you use a label, it points to the first word that is initialized. 

This example shows how to use the .word directive to initialize words. The 
symbol WordX points to the first word that is reserved. 



0001 

0002 

0002 feOO 0c80 

0002 feOl OOff 

0002 fe02 0003 

0003 

0004 



WordX : 



• ds OfeOOh 

•word 3200, Offh, 3 



Here's an example of the .int directive. 



.ds OffOOh 
.int 0,-1, 2, OABCDh 



0005 

0006 LABI 

0006 ffOO 0000 

0006 ffOl ffff 
0006 ff02 0002 
0006 ff03 abed 

»»> FINISHED READING ALL FILES 

»»> ASSEMBLY COMPLETE: ERRORS : WARNINGS :0 
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Chapter 5 

Using the DSK Debugger 



This chapter tells you how to invoke the DSK debugger and use its pulldown 
menus. 

Topic Page 



5.1 Invoking the Debugger 

Displaying a list of available options (? or H option) 5-2 

Se baud (b option) ; 5-2 

Identifying the serial port (com# or c# option) 5-3 

Defining an entry point (e option) 5-3 

Selecting a DTR logic level (i option) 5-3 

Selecting the screen size (I and s options) 5-3 

Setting the configuration mode for memory (m option) 5-3 

5.2 Using Pulldown Menus in the Debugger 5-4 

Escaping from the pulldown menus and submenus 5-4 

Using the Display menu 5-5 

Using the Fill menu 5-6 

Using the Load menu 5-6 

Using the Help menu 5-7 

Using the eXec menu 5-8 

Using the Quit menu 5-8 

Using the Modify menu 5-8 

Using the Op-sys menu 5-9 

Using the Init menu 5-9 

Using the Watch menu 5-10 

Using the Reset menu 5-10 

Using the Save menu 5-10 

Using the Copy menu 5-11 

5.3 Using Dialog Boxes 5-11 
Closing a dialog box 5-13 

5.4 Using Software Breakpoints 5-14 

Setting a software breakpoint 5-14 

Clearing a software breakpoint 5-15 

Finding the software breakpoints that are set 5-15 
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5.1 Invoking the Debugger 

Here's the basic format for the command that invokes the debugger: 




dskd 

options 

Table 5-1 
options. 



is the command that invokes the debugger, 
supply the debugger with additional information, 
the debugger options; the following subsections describe the 



Table 5-1. Summary of Debugger Options 



Option 



?orH 
b rate 

com1, com2 or 
cl, c2 

e address 

i 

I 

m [0..3] 



Brief description 



Displays a listing of the available options 
Selects the valid baud rate 
Selects communication port 1 or 2 

Defines a program entry point 

Selects a logic level for DTR (data terminal ready) 
reset; note that the default DTR is inverse 

Selects the EGA/VGA screen sizes 

Sets the configuration mode (default =1) 

Selects the default screen length of 25 



Displaying a list of available options (? or H option) 



You can display the contents of Table 5-1 on your screen by using the ? or H 
option. For example, enter: 

dskd ? (Z) 



Selecting the baud (b option) 

The valid baud i 

□ b4800 

□ b9600 

□ b19200 

□ b38400 



are: 



5-2 



Using the DSK Debugger 



Invoking the Debugger 



Identifying the serial port (com# or c# option) 

Thed or c2 option identifies the serial port that the debugger uses for commu- 
nicating with your PC. The default setting, d , is used when your serial port is 
connected to COM1 . Depending on your serial port connection, replace serial 
port with one of these values: 

□ If you are using serial communication port 1 , enter: 
dskd cl (3D 

□ If you are using serial communication port 2, enter: 
dskd c2 GD 

Defining an entry point (e option) 

Use option e to set the initial program entry address. The address you select 
must be a four-digit hexadecimal value. For example: 

dskd efbOOh 

The above example sets the DSK debugger at an initial address of fbOOh. 



Selecting a DTR logic level (i option) 

Using option i tells the DSKD to invert DTR (data terminal ready) as a reset 
signal. Usually, the RS232 DTR line is high and pulses low for a reset signal. 
However, if you use the i option (inverse), the DTR line is low and pulses high 
for a reset signal. 



Selecting the screen size (I and s options) 



By default, the debugger uses an 80-character-by-25-line screen. You can use 
one of the options in Table 5-2 to switch between screen sizes. 



Table 5-2. Screen Size Options 



Option 


Description 


I 


80 characters by 43 lines 


s 


80 characters by 25 lines (default) 



Setting the configuration mode for memory (m option) 

Use the m option to configure memory sections in the same way the CONF 
instruction works. Refer to your TMS320C2x User's Guide for more informa- 
tion on the CONF instruction. 



5-3 



Using Pulldown Menus in the Debugger 



5.2 Using Pulldown Menus in the Debugger 

Figure 5-1 shows the main menu bar in the DSK debugger. 

1. The Main Menu Bar 



Display Fill Load Help eXec Quit Modify Op-ays Init Watch Reset Save Copy 



a 



Many of the debugger's pulldown menus have additional submenus. A sub- 
menu is indicated by a main menu selection enclosed in <> characters. For 
example, here's one of the submenus for the Display menu: 



display 
submenu 

format 
submenu 



<display> Data Program Version Status Breakpoints Format Memory 
<format> Unsgnd Int Char pckdstrng Long Fit Double 0.15 Oct hex B-E-T float 

^ y 



Because the DSK debugger supports over 50 commands, it's not practical to 
discuss the commands associated with all of the submenu choices. Here's a 
tip to help you with the DSK commands: the highlighted menu letters form the 
name of the corresponding debugger command. For example, the highlighted 
letters in Display— Format-* Char show that you press QD, GD, Cc] , in that 
order, to display the submenus. 



Escaping from the pulldown menus and submenus 



If you display a menu and then decide that you don't want to make a selection 
from this menu, you can press (He) to return to the main menu bar. 
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Using the Display menu 

Table 5-3 lists the submenu selections for the Display menu. The highlighted 
letters show the keys that you can use for selecting menu choices. 



Table 5-3. Menu Selections for Displaying Information 



To display this 


Display-* 


Data memory 


—Data 


rrogram memory 


— 'rrogram 


Current version of the debugger 


—Version 


Register status 


—Status 


List of set breakpoints 


—Breakpoints 


Format 


—Format 


□ Unsigned integer 


— Unsgnd 


□ Integer 


-Int 


□ Character 


—Char 


□ String 


— pckdStrng 


□ Long 


—Long 


Q floating-point number 


Ell 

—Fit 


□ Double 


—Double 


□ Signed Q1 5 


— Q15 


□ Octal 


—Oct 


□ Hexadecimal 


—hex 


□ Big floating-point number 


— B-E-T float 


^exponeni=i o, rnaniissa=o£/UoU) 




i onon Tioaiiny-poini nurnDer 


— b-c- i noai 


^exoon0nt=1 6* mantissa=16/Q14^ 

V s\ w } lv 1 ' 1. — 1 V) 111 C*i 1 llwwu~ 1 w/ *o< 1 / 




(~1 1 onn flnatinn-nnint nnmhf»r 

^ 1—<J\ ly MUCUMiy JJvll 11 1 IUI HUCI 


-.R-F-T flnat 


(exDonent=32: mantissa=64/Q62) 




Memory 


—Memory 


I - ! Qot a nouu aHrlrocc 
y—i Ocl d 1 lew dUUIcoo 


h AWH race 


□ Big (exponent=16; mantissa=32/Q30) 


-B-E-T float 


□ Double 


—Double 


□ Short floating-point number 


-B-E-T float 


□ Long floating-point number 


-B-E-T float 


□ floating-point number 


-Float 


□ Integer 


-Int 


□ Long 


—Long 


□ Octal 


-Oct 


□ Q15 


-Q15 


□ Insigned integer 


—Unsgnd 


□ Hexadecimal 


-heX 
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Using the Fill menu 

Table 5-4 lists the menu selections for filling memory. The highlighted letters 
show the keys that you can use for selecting menu choices. 

Table 5-4. Menu Selections for Filling Memory 



To fill this 


Fill- 


Data memory 


—Data 


Program memory 


—Program 



Using the Load menu 

Table 5-5 lists the submenu selections for the Load menu. The highlighted 
letters show the keys that you can use for selecting menu choices. 

Table 5-5. Menu Selections for Loading Information into Memory 



To load this 


Load— 


COFFfile 


-COFF 


DSKfile 


-DDK 


Format 


—Format 


□ Unsigned integer 


— Unsgnd 


□ Integer 


-Int 


□ Character 


—Char 


□ String 


— pckdStrng 


□ Long 


—Long 


□ floating-point number 


-Fit 


□ Double 


—Double 


□ Signed Q1 5 


-Q15 


□ Octal 


-Oct 


□ Hexadecimal 


-heX 


□ Big floating-point number 


-B-E-T float 


(exponents 6; mantissa=32/Q30) 




□ Short floating-point number 


-B-E-T float 


(exponents 6; mantissa=16/Q14) 




□ Long floating-point number 


-B-E-T float 


(exponent=32; mantissa=64/Q62) 





Program counter — Programcounter 
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Using the Help menu 



You can use the help menu to bring up monitor information; then press CZ) to 
bring up the help menu shown in Figure 5-2. 



Figure 5-2. The Monitor Info Screen 



Help Window Display 



Page 001 



Usage of the program: dskd [[-) \ ) [options] ] 
Options: Please note that options aren't case significant 



? or H: this^ display 

E: defines with 4 following digits the entry point;: 
A: defines autoselection for old ROM codes 
cl or c2: selects communication port 




To move through the help window, you can use: 

□ PGUP to move ahead a page 

□ PGDN to move back a page 

□ HOME to return to the first page of the help menu 

□ END to go to the last page of the help menu 

□ newPage to go to a specific page number in the help menu 

□ File to print the file help.txt 

□ Quit to exit the help menu and return to the debugger 

□ ESC to exit the help menu and return to the debugger 
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Using the eXec menu 

Table 5-6 lists the menu selections for executing code. The highlighted letters 
show the keys that you can use for selecting menu choices. 

Table 5-6. Menu Selections for Executing Code 

To execute code from eXec-» 

The beginning of your program -»Go 

A particular address —Address 

One line of code to the next — Singlestep/ret/blank 

One line number to the next — Num_steps 

The beginning of a certain function —Function 



Using the Quit menu 

To exit the debugger and return to the operating system, enter this command: 
q (3 

If a program is running or a submenu is displayed, press IescI before you quit 
the debugger to halt program execution or return to the main menu. 



Using the Modify menu 

Table 5-7 lists the menu selections for modifying your code. The highlighted 
letters show the keys that you can use for selecting menu choices. 

Table 5-7. Menu Selections for Modifying Your Code 



To modify 


Modify— 


A register 


—Register 


Your program 


—Program 


Data 


—Data 


An in or out port 


—In/out ports 
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Using the Op-sys menu 



The debugger provides a simple method of entering DOS commands without 
explicitly exiting the debugger environment. To do this, use the Op-sys menu 
by entering this command: 

o El 

If a submenu is displayed, press He) to return to the main menu before 
attempting to enter the operating system. 

The debugger opens a system shell and displays the DOS prompt. At this 
point, you can enter any DOS command. 

When you are finished entering commands and are ready to return to the 
debugger environment, enter: 

exit CZI 

i 1 

Note: 

Available memory may limit the operating-system commands that you can 
enter from a system shell. For example, you would not be able to invoke 
another version of the debugger. 



Using the Init menu 

Using the Init menu initializes the CPU registers and entry point of your 
program. 



5-9 



Using Pulldown Menus in the Debugger 



Using the Watch menu 

Table 5-8 lists the menu selections for watching your code during program 
execution. The highlighted letters show the keys that you can use for selecting 
menu choices. 

Table 5-3. Menu Selections for the Watch Menu 

To change your watch settings Watch- 
Add a variable/value to watch -»Add 
Delete a variable/value to watch —Delete 

Format the variables/values you are —Format 
watching 

Modify the variables/values you are watching —Modify 

Using the Reset menu 

To reset the DSK board, enter this command: 
r C2J 

If a submenu is displayed, press (He) to return to the main menu before you 
reset the board. 



Using the Save menu 

Table 5-9 lists the menu selections for saving code during a debugging 
session. The highlighted letters show the keys that you can use for selecting 
menu choices. 

Table 5-9. Menu Selections for Saving Code 



To save 


Save— 


A register value 


—Register 


Data 


—Data 


Your program 


—Program 


A certain format 


—Format 
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Using the Copy menu 

Table 5-1 lists the menu selections for copying information. The highlighted 
letters show the keys that you can use for selecting menu choices. 

Table 5-10. Menu Selections for Copying Information 

To copy from -* to Copy-* 

Data to data —Data-* data 

One program to another program -»Program— program 

Data to your program -»dAta— program 

Your program to data -»pRogram-» data 



5.3 Using Dialog Boxes 



Some of the debugger commands have parameters. When you execute these 
commands from pulldown menus, you must have some way of providing 
parameter information. The debugger allows you to do this by displaying a dia- 
log box that asks for this information. 

Entering text in a dialog box is much like entering commands in the operating 
system. For example, when you select Program from the Fill submenu, the 
debugger displays a dialog box that asks you for parameter information. The 
dialog box looks like this: 



Fill Memory 



Fill Program Memory 
Start Address: 
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To enter a start address, just type, and then press CZI . The next parameter ap- 
pears in the dialog box: 



Fill Memory; 



Fill Program Memory 
Start Address: 0500h 
Length : 



x: : ■ : - : :V: :: :::::: : 



You can omit entries for optional parameters by pressing CZI , but the debugger 
won't allow you to skip required parameters. When you have entered all ap- 
propriate parameter values, Fill Program Memory finished appears at the bot- 
tom of the dialog box. 

In the case of the Modify menu, when you select Data from its submenu, an 
empty dialog box appears on the screen: 



Modify Data Memory of 320c26 



Using the DSK Debugger 



Using Dialog Boxes 



Press GE) for the debugger to display the first parameter: 



Modify Data Memory of 320c26 
Address: 0000 > ffd8 new: 



Enter the address you want 1 
pears in the dialog box. 



I press O . The next parameter ap- 







Modify 


Data 


Memory 


Address: 


0000 


> ffd8 


new: 


0500 


Address : 
Address : 


0000 
0001 


> ffd4 

> 0500 


new: 


000c 


Address : 
Address : 


0001 
0002 


> 000c 

> e7b2 


new: 


q 



When you've entered a value for the final parameter, enter q and press C3 at 
the next prompt; the debugger closes the dialog box and executes the com- 
mand with the parameter values you supplied. 



Closing a dialog box 

There are three possible ways to exit from a dialog box: 

□ press (He), 

□ pressCS, or 

□ press GO and S . 
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5.4 Using Software Breakpoints 



This section describes the processes of setting and clearing software break- 
points and of obtaining a listing of all the breakpoints that are set. 



During the debugging process, you may want to halt execution temporarily so 
that you can examine the contents of selected variables, registers, and 
memory locations before continuing with program execution. You can do this 
by setting software breakpoints in the assembly language code. A software 
breakpoint halts any program execution, whether you're running or single- 
stepping through code. 



When you set a software breakpoint, the debugger highlights the breakpointed 
line in a bolder or brighter font. The highlighted statement appears in the re- 
verse assembly window. 

After execution is halted by a breakpoint, you can continue program execution 
by reissuing any of the run or single-step commands. 

You can set a software breakpoint by entering either the BA command or the 
BE command. 

ba If you know the address where you'd like to set a software breakpoint, you can 
use the BA command. This command is useful because it doesn't require you 
to search through code to find the desired line. When you enter the BA com- 
mand, the debugger asks you to enter an absolute address. Once you have 
entered the address, you are asked to choose the line number you want the 
breakpoint set on. Figure 5-3 shows a breakpoint set at address ffd4 on line 
number four. Note that you cannot set multiple breakpoints at the same state- 
ment. 



Setting a software breakpoint 



Figure 5-3. Setting a software breakpoint 




Breakpoints 




Add = OOOOOh Instr = OOOOOh Enabled 

1 Add = OOOOOh Instr = OOOOOh Disabled 

2 Add = OOOOOh Instr = OOOOOh Disabled 

3 Add = OOOOOh Instr = OOOOOh Disabled 



0ffd4h Instr -OOOOOh Enabled 



5 Add » OOOOOh Instr «' OOOOOh Disabled 

6 Add "OOOOOh Instr - OOOOOh Disabled 

7 Add » OOOOOh Instr « OOOOOh Disabled 
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be If you don't know a specific address, you can enter the BE (breakpoint enable/ 
disable) command. The debugger displays a list of addresses as shown in 
Figure 5-3, and asks you what line number you want to set a breakpoint on. 

Clearing a software breakpoint 

bd If you'd like to clear a breakpoint, you can use the BD command. Once you 
enter bd, the Breakpoints box appears on the screen (see Figure 5-3). The 
debugger then asks you which line number contains the breakpoint you want 
to delete. When you enter the line number, the breakpoint is disabled. 

Finding the software breakpoints that are set 

bl Sometimes, you may need to know where software breakpoints are set. The 
BL command provides an easy way to get a complete listing of all the software 
breakpoints that are currently set in your program. The BL command displays 
the Breakpoints box shown in Figure 5-3. 
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5.5 Quick-Reference Guide 

The following tables provide a quick-reference guide of the function key 
definitions, floating-point formats, and register definitions. 



Function Kev 

1 ill IvIIWl 1 l\VJ 


Description 


F1 


Displays help information 


F2 

It 


Prints thp rnntpntQ of thp Qrrppn tn a filp nsmAH c^rppn cm 
niiuo II ic UUI llcilLo \J\ ll IC out Cell LU d lilt? liaillcu su ptr/i.Wn 


F3 


Dtenlav^ thp riirpctnrv 


F4 


not used 


F5 


Fypciitpq vnur nrnnram tn thp npvt hrpaknnint 


F6 


not used 


F7 


not used 


F8 


Single-steps your program 


F9 


not used 


F10 


Single-steps your program and step past calls 


F11 or 




shift + F1 


Displays the reverse assembly window 


F12or 




shift + F2 


Turns the trace on or off (this key acts as a toggle switch) 



Floating-point 

Format Description 



.float 


32-bit IEEE standardized floating-point format 


.double 


64-bit IEEE standardized double floating-point format 


.bfloat 


16-bit exponent + 32-bit mantissa 




(exponent is 2s complement / mantissa = Q30 


.tfloat 


32-bit exponent + 64-bit mantissa 




(exponent is 2s complement / mantissa = Q62 


.efloat 


1 6-bit exponent + 1 6-bit mantissa 




(exponent is 2s complement / mantissa = Q14 
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Register 


Definition 


Description 


ACCU 


accumulator 


32 bits with a carry in ST1 


PREG 


product register 


32 bits used for 1 6 x 1 6 
multiplication 


TREG 


temporary register 


16 bits for multiplication and 

ertpr>iol inofri iHlnne 

bpcLidl II iMiucuuns 


AR/ 


auxiliary register 


16 bits with n=0.7 used as a 
counter and pointer 


STO 


status register 


16 bits 


ST1 


status register 1 


16 bits 


o 1 Oft/ 


siacK register 


i o Dits witn n=o.7 used tor 
hardware stacking (note 
that the debugger uses one 
stack level for itself) 


DRR 


data receive register at address 


16 bits for use with the 
serial porc 


DXR 


data transmit register at address 1 


16 bits for use with the seri- 

a\ nr\rt 
dl \J\Jl I 


TM 


timer register at address 2 


16 bits 


PRD 


period register at address 3 


16 bits 


MSK 


interrupt mask register at address 4 


6 bits for masking 6 

intarri mtc 

ii iici rupib 


GREG 


global register at address 5 


8 bits to define data 

mtrniuiy do yiuudl 


ARP STO 


auyiliarv rprii«5tpr nnintpr 
auAiitciiy icyioici ^juiiilci 


^ hit<s 


ARB ST1 


m lyilinrv rpnicitpr nnintpr hiiffpr 
dUAiiiaiy leyibitri punuer uuilci 


^ Kite 


INTM STO 


interrupt mode (enable global in- 

tarn int\ 

[oriupii 


1 bit 


CNF ST1 


infprnal nmnram/Hata f^nnfinnratinn 
ii ilci i iai pi uy i di i i/UQia l-ui 1 1 ly ui auui I 






F9Y mnHp hit 
"OA lllUUc Ull 


1 hit 
1 Oil 


PM ST1 

i ivi yJ i i 


PmHurt" rftni^tftr tn arn imi ilatnr Qhift 

mode 




CST1 


carry bit 


1 bit 


TCST1 


test / control 


1 bit 


FO ST1 


serial port control (8/16 bit mode) 


1 bit 


HM ST1 


hold mode selection 


1 bit 
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DSK Schematics 



This appendix contains the schematics for the DSP Starter Kit. 



Topic 


Page 


A.1 TMS320C2X DSP Starter Kit 


A-2 



A-1 



TMS320C2X DSP Starter Kit 




Note: 

Dimensions are in inches. 
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DSK Schematics 



\A0 



VCC 
A 



\A8 3 6 



\A9 



\A10 38 



\ Al 1 3 9 



\A12 40 



\A13 41 



\A14 42 



PS\ 




DS\ 




STRB\ 


49 c 


R/W 


4 8 L 


HOLDA\55„ 


MSC\ 




IACK\ 




BR\ 




CLK1 


58 
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Appendix B 

Glossary 



absolute address: An address that is permanently assigned to a memory 
location. 

assembler: A software program that creates a machine-language program 
from a source file that contains assembly language instructions, direc- 
tives, and macro directives. The assembler substitutes absolute opera- 
tion codes for symbolic operation codes, and absolute or relocatable ad- 
dresses for symbolic addresses. 

assignment statement: A statement that assigns a value to a variable. 

autoexec.bat: A batch file that contains DOS commands for initializing your 
PC. 



B 



batch file: One of two different types of files. One type contains DOS com- 
mands for the PC to execute. A second type of batch file contains debug- 
ger commands for the debugger to execute. The PC doesn't execute 
debugger batch files, and the debugger doesn't execute PC batch files. 

block: A set of declarations and statements that are grouped together with 
braces. 

breakpoint: A point within your program where execution will halt because 
of a previous request from you. 

byte: A sequence of 8 adjacent bits operated upon as a unit. 
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code-display windows: Windows that show code, text files, or code- 
specific information. 

command file: A file that contains linker options and names input files for 
the linker. 

command line: The portion of the COMMAND window where you can enter 
commands. 

command-line cursor: A block-shaped cursor that identifies the current 
character position on the command line. 

comment: A source statement (or portion of a source statement) that is 
used to document or improve readability of a source file. Comments are 
not assembled. 

common object file format (COFF): An object file that promotes modular 
programming by supporting the concept of sections. 

constant: A numeric value that can be used as an operand. 

cross-reference listing: An output file created by the assembler that lists 
the symbols that were defined, what line they were defined on, which 
lines referenced them, and their final values. 

cursor: An icon on the screen (such as a rectangle or a horizontal line) that 
is used as a pointing device. The cursor is usually under keyboard con- 
trol. 



D_DIR: An environment variable that identifies the directory containing the 
commands and files necessary for running the debugger. 

debugger: A window-oriented software interface that helps you to debug 
DSK programs running on a DSK board. 

directive: Special-purpose commands that control the actions and func- 
tions of a software tool (as opposed to assembly language instructions, 
which control the actions of a device). 

disassembly: Assembly language code formed from the reverse-assembly 
of the contents of memory. 
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DSP: Digital signal | 
DTR: Data terminal ready. 



EGA: Enhanced Graphics Adaptor. An industry standard for video cards. 

entry point: The starting execution point in target memory. 

expression: A constant, a symbol, or a series of constants and symbols 
separated by arithmetic operators. 

external symbol: A symbol that is used in the current program module but 
defined in a different program module. 



field: A software-configurable data type whose length can be programmed 
to be any value in the range of 1-8 bits. 

file header: A portion of a COFF object file that contains general informa- 
tion about the object file (such as the number of section headers, the type 
of system the object file can be downloaded to, the number of symbols 
in the symbol table, and the symbol table's starting address). 



global: A kind of symbol that is either 1) defined in the current module and 
accessed in another, or 2) accessed in the current module but defined 
in another. 



input section: A section from an object file that will be linked into an 
executable module. 



label: A symbol that begins in column 1 of a source statement and corre- 
sponds to the address of that statement. 

listing file: An output file created by the assembler that lists source state- 
ments, their line numbers, and any unresolved symbols or opcodes. 

LSB: Least significant bit. 

LSByte: Least significant byte. 



member: An element or variable of a structure, union, or enumeration. 

memory map: A map of target system memory space that is partitioned into 
functional blocks. 

menu bar: A row of pulldown menu selections found at the top of the debug- 
ger display. 

mnemonic: An instruction name that the assembler translates into ma- 
chine code. 

MSB: Most significant bit. 

MS Byte: Most significant byte. 



named section: 1) An initialized section that is defined with a .sect direc- 
tive, or 2) an uninitialized section that is defined with a .usect directive. 
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object file: Afile that has been assembled and contains machine-language 
object code. 

operand: The arguments or parameters of an assembly language instruc- 
tion, assembler directive, or macro directive. 

options: Command parameters that allow you to request additional or spe- 
cific functions when you invoke a software tool. 




PC: Personal computer or program counter, depending on the context and 
where it's used in this book: 1) In installation instructions or information 
relating to hardware and boards, PC means Personal Computer (as in 
IBM PC). 2) In general debugger and program-related information, PC 
means Program Counter, which is the register that identifies the current 
statement in your program. 

pulldown menu: A command menu that is accessed by name from the 
menu bar at the top of the debugger display. 
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raw data: Executable code or initialized data in an output section. 




section: A relocatable block of code or data that will ultimately occupy con- 
tiguous space in the memory map. 

serial port: The serial port that the debugger uses for communicating with 
the emulator or the applications board. The port address is selected, de- 
pending on which communication port the debugger is attached to. 

single-step: A form of program execution that allows you to see the effects 
of each statement. The program is executed statement by statement; the 
debugger pauses after each statement to update the data-display 
windows. 

source file: A file that contains C code or assembly language code that will 
be assembled to form a temporary object file. 
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SPC: Section program counter. 



static: A kind of variable whose scope is confined to a function or a pro- 
gram. The values of static variables are not discarded when the function 
or program is exited; their previous value is resumed when the function 
or program is re-entered. 

string table: A table that stores symbol names that are longer than 8 char- 
acters (symbol names of 8 characters or longer cannot be stored in the 
symbol table; instead, they are stored in the string table). The name por- 
tion of the symbol's entry points to the location of the string in the string 
table. 

structure: A collection of one or more variables grouped together under a 
single name. 

symbol: A string of alphanumeric characters that represents an address 
or a value. 




tag: An optional "type" name that can be assigned to a structure, union, or 
enumeration. 
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unconfigured memory: Memory that is not defined as part of the memory 
map and cannot be loaded with code or data. 

union: A variable that may hold (at different times) objects of different types 
and sizes. 

unsigned: A kind of value that is treated as a positive number, regardless 
of its actual sign. 
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VGA: Video Graphics Array. An industry standard for video cards. 
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window: A defined rectangular area of virtual space on the display, 
word: A 1 6-bit addressable location in target memory. 
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Glossary 



Index 



? debugger option 5-2 



A 



absolute address, definition B-1 

AC transformer, power requirements 1 -2 

adding a software breakpoint 5-1 4 

adding a watch variable 5-1 

asm assembler option 3-11 

assembler 2-4, 3-1 to 3-12 

-I option 2-5 

constants 3-7 

definition B-1 

description of 2-2 

directives 4-1 to 4-26 

executable file 1-3 

expressions 3-9 

key features 2-2 

options 3-10 

source, listings 3-2 

source statement format 3-2 

symbols 3-8 
assembler directives. See directives 
assembling your program 3-1 
assembly-time constants 4-22 
assigning a value to a symbol 4-22 
assignment statement, definition B-1 
autoexec.bat 1-7 
autoexec.bat file, definition B-1 
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b debugger option 5-2 
BA command 5-14 
backup of product disk 1 -6 
batch files 



config.sys 1-6 
sample 1-7 

definition B-1 

invoking.autoexec.bat 1-7 
baud 5-2 

error 1 -9 
BBS, updating the DSK software vi 
BD command 5-1 5 
.bfloat 5-16 

assembler directive, 4-8 4-17 
binary integers 3-7 
BL command 5-1 5 
block, definition B-1 
breakpoints. See software breakpoints 
breakpoints (hardware), definition B-1 
breakpoints (software), definition B-1 
.byte, assembler directive 4-8, 4-11 
byte, definition B-1 
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c or com debugger option 5-3 
C1/C2, error 1-9 
d /c2 debugger option 1 -8 
cable, requirements 1-2,1-4 
character, constants 3-7 
clearing software breakpoints 5-15 
closing a dialog box 5-1 3 
code-display windows, definition B-2 
COFF, definition B-2 
com 1/com2, error 1-9 
com1/com2 debugger option 1 -8 
command file, definition B-2 
command line 

defining assembler statements 3-11 

definition B-2 
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Index 



comment, definition B-2 

comments 3-6 to 3-7 

in assembly language source code 3-6 

communication, link between PC and DSK 1-2 
communication port, error 1 -9 
conditional assembly, directives 4-7 
conditional block 4-18 
definition B-1 

config.sys 

modifying 1 -6 

sample 1-7 
configuration, data/program memory 5-3 
connecting the DSK board to your PC 1 -5 
constant, definition B-2 

constants 3-7, 3-8 

assembly-time 3-7, 4-22 
binary integers 3-7 
character 3-7 
decimal integers 3-7 
floating-point 4-17 
hexadecimal integers 3-7 
symbols as 3-7 

.copy 

assembler directive 4-1 2 
assembler directives 4-6 

copy files 4-6,4-12 

Copy menu 5-11 

copying, disk to hard drive 1 -6 

copying information 5-11 

cross-reference listing B-2 

cursors 

command-line cursor, definition B-2 
definition B-2 



-d assembler option 3-11 

D_DIR environment variable, definition B-2 



assembler directive 4-4, 4-1 4 
section 4-4,4-14 

data, memory, configuring 5-3 

DB25 connection 1-4 

DB9 connection 1 -4 



debugger 

definition B-2 
description of 2-2 to 2-3 
display, basic 2-3 
executable file 1-3 
exiting 5-8 

exiting to the operating system 5-9 
installation 1-6 
invoking 5-2 
key features 2-3 
menu bar 5-4 

submenus 5-4 
options 5-2 

? 5-2 

b 5-2 

c or com 5-3 

e 5-3 

h 5-2 

i 5-3 

I 5-3 

m 5-3 

s 5-3 

pulldown menus, using 5-4 

debugger environment, setting up 1 -7 

decimal integer constants 3-7 

deleting a watch variable 5-1 

developing code 2-4 

dialog box, closing 5-13 

dialog boxes, using 5-11 

directives 4-1 to 4-26 

alphabetical reference 4-10 
assembler 

binary integers 3-7 

character constants 3-7 

hexadecimal integers 3-7 
assembly-time constants 4-22 
assembly-time symbols .set 4-22 
conditional assembly 4-2, 4-7 

.else 4-7,4-18 

.endif 4-7,4-18 

.if 4-7,4-18 
define sections 4-2, 4-4 

.data 4-4,4-14 

.ds 4-4 

.entry 4-4 

.ps 4-4, 4-24 

.text 4-4,4-24 
definition B-2 
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directives (continued) 

initialize constants 4-3, 4-8 to 4-9 
Moat 4-8, 4-17 
.byte 4-8,4-11 
.double 4-8,4-17 
Moat 4-8,4-17 
.float 4-8,4-17 
.int, 4-8 

.long 4-8, 4-20 

.Iqxx 4-8,4-21 

.qxx 4-8, 4-21 

.space 4-9, 4-23 

.string 4-8, 4-11 

Moat 4-8,4-17 

.word 4-8,4-26 
initializing the load address, .ds 4-14 
listing your output, .liston 4-1 9 
miscellaneous 4-3, 4-9 

.end 4-9,4-15 

.entry 4-16 

.listoff 4-9 

.liston 4-9 

.set 4-9 
reference other files 4-2 

.copy 4-6, 4-12 

.include 4-6, 4-12 

directories 

dsktools directory 1-6 

for debugger software 1 -6, 1 -7 

disabling software breakpoints 5-15 

disassembly, definition B-2 

display directory, function key method 5-1 6 

display help information, function key method 5-1 6 

Display menu 5-5 
submenus 
Format 5-5 
Memory 5-5 

display requirements 1 -2 

display reverse assembly contents, function key 
method 5-16 

displaying information, menu selections 5-5 

documentation, related vi 

.double 5-16 

assembler directive 4-8, 4-1 7 

.ds 

assembler directive 4-4, 4-1 4 
section 4-4 



DSK software, updates with the BBS vi 

dska command 2-5, 3-1 

dska.exefile 1-3 

dskd command 1-8,2-5,5-2 

dskd.exefile 1-3 

DSP, defined B-3 

DTR, defined B-3 

DTR logic level, selecting 5-3 
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e debugger option 5-3 
.efloat 5-16 

assembler directive 4-8 

assembler directive 4-17 
EGA, definition B-3 

electronic bulletinboard, updating DSK software vi 

.else, assembler directive 4-7,4-18 

enabling software breakpoints 5-15 

.end, assembler directive 4-9, 4-15 

.endif, assembler directive 4-7, 4-1 8 

.entry, assembler directive 4-4, 4-1 6 

entry point 

defining 5-3 

definition B-3 
eXec menu 5-8 

execute program to breakpoint, function key meth- 
od 5-16 

executing code, menu selections 5-8 
exiting the debugger 5-8 
expressions 3-9 




definition B-3 



field, definition B-3 
file header, definition B-3 
filenames, copy/include files 4-6 
Fill menu 5-6 

submenus, Program 5-11 
filling memory, menu selections 5-6 
.float 5-16 

assembler directive 4-8, 4-1 7 
floating-point constants 4-1 7 
function keys, definition 5-16 
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Index 
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getting started 2-5 

global symbol, definition B-3 
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h debugger option 5-2 
hardware requirements 1 -2 
Help menu 5-7 
hexadecimal integers 3-7 
host system 1 -2 




i debugger option 5-3 

.if, assembler directive 4-7, 4-1 8 

.include, assembler directive 4-6, 4-1 2 

include, files 4-6 

include files 4-12 

Init menu 5-9 

initializing 

CPU registers 5-9 

program entry point 5-9 
input section, definition B-4 
installation 

debugger software 1 -6 

errors 1 -9 

hardware connections 1-5 

verifying 1 -8 
.int, assembler directive 4-8 
.int assembler directive 4-26 
invoking, assembler 3-10 
invoking the debugger 5-2 
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-k assembler option 3-1 




-I assembler option 3-11 
I debugger option 5-3 
-I option 2-5 



label, definition B-4 
labels 3-3,3-8 

case sensitivity 3-3 

in assembly language source 3-2 

syntax 3-2 

using with .byte directive 4-11 
listing file, definition B-4 
listing software breakpoints, 5-15 
.listoff, assembler directive 4-9, 4-19 
.liston, assembler directive 4-9, 4-1 9 
Load menu 5-6 

submenus, Format 5-6 
loading information, menu selections 5-6 
.long, assembler directive 4-8, 4-20 
.Iqxx, assembler directive 4-8, 4-21 
LSB 4-3,4-8,4-21 

defined B-4 
LSByte, defined B-4 




member, definition B-4 
memory 
filling 5-6 

loading information into, menu selections 5-6 

requirements 1 -2 
memory map, definition B-4 
menu bar 5-4 

definition B-4 
menu selections, definition (pulldown menu) B-5 
mnemonic, definition B-4 
mnemonic field 3-4 

syntax 3-2 
Modify menu 5-8 

submenus, Data 5-12 
modifying your code 5-8 
MS-DOS, software requirements 1-3 
MSB 3-3 

definition B-4 
MSByte, definition B-4 




named section, definition B-4 
notational conventions iv 
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object file 

creating 3-11 

definition B-5 
Op-sys menu 5-9 
opcodes, defining 3-4 
operand, definition B-5 

operands 3-5 

label 3-8 

prefixes 3-5 
operating system 

accessing from within the debugger environ- 
ment 5-9 

requirements 1-3 

returning to the debugger 5-9 

options 

assembler 3-1 to 3-1 2 
debugger 5-2 
definition B-5 

output file 

disassembling 3-11 
generating 3-1 




PATH statement 1-7 

PC, definition B-5 

PC-DOS, software requirements 1-3 

pin assignments, RS-232 connections 1-4 

port, definition B-5 

power requirements 
9 VAC 1-2 

using the DSK on-board power supply 1 -2 

print screen, function key method 5-1 6 

program 

assembling 3-10 
entry point 5-9 

defining 5-3 

definition B-3 
memory, configuring 5-3 

program execution, using the pulldown menus 5-8 

•PS 

assembler directive 4-4, 4-24 
section 4-4 



pulldown menu 
eXec menu 5-8 
Help menu 5-7 
Load menu 5-6 

pulldown menus 
Copy menu 5-11 
definition B-5 
Display 5-5 
escaping from 5-4 
Fill menu 5-6 
In'rt menu 5-9 
Modify menu 5-8 
Op-sys menu 5-9 
Quit menu 5-8 
Reset menu 5-10 
Save menu 5-10 
submenus 5-4 
using 5-4 
Watch menu 5-10 
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Quit menu 5-8 

.qxx, assembler directive 4-8, 4-21 



raw data, definition B-5 
reference guide 5-16 
register definitions 5-1 7 
requirements, power, 9- VAC 1-2 
Reset menu 5-10 
resetting the DSK board 5-1 
RS-232 connections 1-4 
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s debugger option 5-3 

Save menu 5-10 

saving code 5-10 

schematics A-2 

screen size, selecting 5-3 

section, definition B-5 

section program counter. See SPC 

serial port 

identifying 5-3 

requirements 1-2 



Index 



»«""""*""" 



mmmm. 



mmm 



.set, assembler directive 4-9, 4-22 
signal name, RS-232 connections 1-4 
single-step 

definition B-5 

function key method 5-16 
software breakpoints 5-14 

BA command 5-14 

BD command 5-1 5 

BE command 5-1 5 

BL command 5-1 5 

clearing 5-15 

listing 5-15 

setting 5-14 
software requirements 1-3 
source 

listings 3-2 

statement 
format 3-2 

comment field 3-6 
label field 3-3 
mnemonic field 3-4 
operand field 3-5 
number (source listing) 3-2 
source file, definition B-5 
source files 3-2 to 3-6 

commenting 3-6 to 3-7 

labeling 3-3 

opcodes 3-4 
.space, assembler directive 4-9, 4-23 
SPC 

assigning a label to 3-3 
assigning an initial value 4-14 
definition B-6 
setting starting address 4-4 
value, associated with labels 3-3 

statements, defining from the command line 

static variable, definition B-6 

.string, assembler directive 4-8, 4-1 1 

string table, definition B-6 



3-11 



structure, definition B-6 
submenus 5-4 
symbol, definition B-6 
symbols 3-8 

assigning values to 4-22 



tag, definition B-6 

temporary object file, creating 3-1 1 

.text 

assembler directive 4-4, 4-24 

section 4-4 
.tfloat 5-16 

assembler directive 4-8, 4-1 7 
trace, turning on/off, function key method 
transformer, power requirements 1-2 



unconfigured memory, definition B-6 
union, definition B-6 
unsigned, definition B-6 
5-11 



5-16 



VGA, definition B-6 



warranty information, void if modified 1 -2 

Watch menu 5-10 

windows, definition B-7 

.word, assembler directive 4-8, 4-26 

word, definition B-7 
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